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1.  Introduction 


FAIL  is  an  assembly  program  for  PDP-6  and  PDP  10  machine  language  FAIL  operates  in  one 
pass  which  means  that  it  reads  the  input  file  only  once;  the  linking  loader  program  (LOADER  or 
LINK- 10)  completes  any  aspects  of  the  assembly  which  could  not  be  done  by  FAIL.  The 
«ricl«  wZch  have*  been  employed  m  Us  coding  make  FAIL  h»e  times  faster  than 

MACRO- 10,  the  DEC  assembler 

FAIL  processes  source  program  statements  by  translating  mnemonic  operation  codes  into  the 
binary Pcodes  needed  in  machine  instructions,  relating  symbols  to  numeric  values,  and  assigning 
relocataMe  or  absolute  core  addresses  for  program  instructions  and  data.  The  assembler  can 
prepare  a  listing  of  the  program  which  includes  a  representation  of  the  assembled  code.  Also,  the 
assembler  notifies  the  user  of  any  errors  detected  during  the  assembly. 

FAIL  has  a  powerful  macro  processor  which  allows  the  programmer  to  create  new  language 
elements  to  perform  special  functions  foi  each  programming  job. 

FAIL  permits  an  ALGOL-style  block  structure  which  provides  a  way  of  localizing  the  usage  of 
fymboh  to  particular  parts  of  the  program,  called  blocks.  Block  structure  allows  the  same  symbol 
name  to  be  given  different  meanings  in  different  blocks. 

Thp  rpaf1pr  of  thl-  mariual  should  be  familiar  with  the  PDP- 10  instruction  set,  which  is  described 
m  bmb  O£C sys.I“  5,, Monuof  aod  PDP-IO  and  PDP-6  Ms, rue, Ion  M. 

(SAILON-71). 

Other  documents  of  interest: 

Frost  M.  UUO  Manual ,  SAILON-55.3,  December  1973 

Petit,  P.  /M/D,  SAILON-58.  September  1969 

Harvey,  B.  Monitor  Command  Manual,  SAILON-54.3,  December  19 

The  following  are  available  in  the  DECsystem-10  Sojtware  Notebooks-. 

Cross-Reference  Listing:  CREF ,  June  1973 
DDT-10  Programmer’s  Reference  Manual,  June  1973 
Linking  Loader  Programmer’s  Reference  Manual,  August  1971 
LINK-10  Programmer's  Reference  Manual,  May  1973 
MACRO-10  Assembler  Programmer’s  Reference  Manual,  June  1972 
DECsystem-10  Operating  System  Commands,  February  1974 
DECsystem-10  Monitor  Calls,  June  1973 
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2.  Basic  Syntax 


This  section  describes  the  basic  components  of  a  typical  FAIL  source  program.  It  covers  the 
normal  mode  of  turning  each  source  statement  into  a  binary  word  Pseudo  operations  and  macro 
features  are  explained  in  later  sections 

This  section  is  organized  in  a  top  down  manner  the  complex  constructs,  statements,  are  descubed 
first,  followed  by  a  description  of  the  'anguage  elements  from  which  statements  are  built,  etc 

Statements  are  the  elements  of  the  language  that  generate  machine  code  and  other  binary  data  A 
statement  is  generally  free  format,  consisting  of  several  fields,  each  oi  which  is  ari  expression 
Expressions  are  composed  of  atoms  and  operators,  The  operators  signify  typical  arithmetic  and 
boolean  operations,  such  as  addition  01  logical  OR.  Atoms  are  either  constants,  symbols,  or 
complex  atoms. 


2.1  Statements 

Statements  are  the  syntactic  units  which  actually  produce  code.  The  statements  that  are  described 
in  this  section  usually  generate  one  word  of  code  A  null  statement,  which  consists  of  no 
expressions,  generates  no  code  A  typical  statement  consists  of  one  or  more  expressions  separated 
by  spa  °s,  commas,  or  parentheses 

There  are  five  kinds  of  statements:  instruction  statements,  full-word  expressions,  truncat'd 
expressions,  halfword  statements,  and  input-output  statements  The  most  common  of  these  is  the 
instruction  statement  Also,  there  are  pseudo-operations  (called  pseudo-ops),  which  are  described 
in  section  3,  page  22.  A  pseudo-op  may  direct  FAIL  to  perform  an  assembler  control 
function  oi  to  assemble  data  in  a  particular  format 

The  examples  that  an5  given  below  are  intended  to  be  as  general  as  possible  In  most  cases,  many 
of  the  indicated  fields  may  be  omitted. 

2.1.1  Instruction  Statement 
OPCODE  AC. ^ADDRESS!  INDEX)  ;C0ni1ENT 

An  instruction  statement  is  used  to  assemble  one  machine  instruction.  The  typical  format  is 
shown  above;  the  parts  will  be  explained  later.  Any  portion  of  the  instruction  statement  may  be 
omitted.  The  comment  field  is  not  really  pat t  of  the  instruction  statement,  but  may  be  included  on 
the  same  line  for  clarity  and  conciseness  The  parts  may  appear  in  any  order,  except  that  the 
opcode  field,  if  present,  must  be  the  first  expression.  Abo,  each  part  must  be  syntactically 
identifiable  The  form  above  is  hallowed  by  years  of  use,  departure  from  it  will  render  a 
pregram  less  intelligible  to  other  readers. 
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If  the  opcode  field  is  omitted,  all  other  fields  will  be  recognized  and  handled  normally,  unless  the 
address  expression  is  the  first  field  seen,  in  which  case  the  statement  is  treated  as  a  full-word 
expression. 


2.1. 1.1  Opcode  Field 


If  the  first  atom  appearing  in  the  statement  (excluding  labels  and  assignment  statements)  is  an 
identifier,  it  will  be  looked  up  in  the  opcode  table  to  see  if  it  is  an  opcode,  in  which  case  the 
opcode  alone  will  be  returned  as  the  first  expression,  overriding  any  significance  it  may  have  as  a 
symbol.  An  opcode  (short  for  operation  code)  may  be  a  machine  instruction  mnemonic,  a  UUO 
mnemonic,  a  pseudo-op,  or  a  user-defined  opcode  (see  OPDEF  in  section  3.2.1,  page  26).  An 
opcoc  e,  if  it  appears,  must  be  the  first  thing  in  the  statement  (except  ior  labels  or  assignment 
statements) 

If  an  opcode  is  a  pseudo-op  mnemonic,  FAIL  will  process  that  particular  pseudo-op  as 
appropriate.  The  syntax  of  pseudo-ops  differs  from  that  of  normal  statements. 

If  an  opcode  is  a  machine  instruction,  UUO  mnemonic,  or  user  opcode,  its  value  is  placed  in  the 
binary  word  being  assembled  These  opcodes  are  treated  as  having  full-word  values,  but  in  most 
oases  only  the  opcode  field  (bits  0-8)  is  non-zero  A  few  machine  instructions,  and  many  UUO 
mnemonics,  specify  values  for  other  fields  as  well.  The  values  of  the  other  fields  (except  the 
address  field,  if  non-zero)  can  be  modified  by  subsequent  operands. 

Whenever  an  opcode  is  recognized,  it  is  immediately  processed  without  regard  for  any  arithmetic 
operator  that  might  follow.  Although  FAIL  tries  to  allow  a  symbol  and  opcode  with  the  same 
name  to  co  exist,  it  cannot  resolve  the  ambiguity  in  all  circum  .<mces,  it  is  a  good  idea  to  avoid 
conflicts  as  n  uch  as  possible.  FAIL  will  not  recognize  an  identifier  as  an  opcode  if  the  identifier  is 
followed  by  any  one  of  the  characte.  •  colon  (:),  left-arrow  (♦-),  up-arrow  (t),  tilde  (~),  or  number 
s  gn  (#). 


2.1. 1.2  Accumulator  (AC)  Field 


If  an  expression  appears  in  a  statement  followed  by  exactly  one  comma,  its  value  will  be  placed  in 
the  accumulator  field  of  the  current  word  (bits  9-12),  possibly  replacing  the  accumulator  field 
indicated  by  an  opcode.  This  expression  must  be  defined,  available,  and  absolute  (some  of  these 
terms  are  defined  in  section  2.3.2,  page  8).  Fur  the  sake  of  brevity,  "accumulator"  is  often 
written  as  ”AC”. 


2. 1.1.3  Indirect  (@)  Field 


If  one  or  more  at-sign  characters  (®)  appear  as  part  of  a  statement,  the  indirect  bit  (bit  13)  will  be 
turned  on  in  the  word  being  assembled.  The  at-sign  may  appear  anywhere  in  the  statement  as 
long  as  it  is  not  embedded  inside  symbols  or  expressions.  The  character  open  single  quote  (*) 
may  be  used  as  an  alternative  to  at-sign. 
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2.1. 1.4  Address  Field 


If  in  a  statement  an  expression  appears  which  is  neither  enclosed  in  parentheses  nor  followed  by  a 
comma,  it  is  considered  to  be  an  address  expression  unless  it  is  the  first  expression  (including  the 
opcode)  in  the  statement  Address  expressions  are  truncated  to  18  bits  and  placed  in  the  address 
field  (bits  18-35)  of  the  word  being  assembled. 

Only  one  -ddress  field  may  be  assembled  per  statement;  an  attempt  to  assemble  more  than  one  is 
an  error  This  error  sometimes  occurs  because  an  undefined  opcode  is  used,  which  is  treated  as  an 
expression  in  case  it  is  really  an  undefined  symbol  This  error  can  also  occur  when  an  opcode 
includes  an  address  field  and  the  user  attempts  to  supply  another  address  field. 


2.1.1  5  Index  Field 


If  an  expression  is  enclosed  in  parentheses  in  a  statement,  the  right  half  of  its  value  will  be  ORed 
into  the  left  half  of  the  current  word.  Also,  if  no  address  field  has  appeared  yet,  the  left  half  of  its 
value  will  be  ORed  into  the  right  half  of  the  current  word.  The  expression  must  be  defined, 
available,  and  absolute  This  construct  is  most  commonly  used  for  specifying  the  index  field  (bits 


Sometimes,  this  construct  is  used  for  putting  left-half  quantities  in  address  fields,  or  as  a  general 
halfword-swapping  operation  Often  when  this  is  done,  the  expression  in  parentheses  must  be 
enclosed  in  brokets  (<  and  >)  to  force  its  evaluation  as  an  atomic  statement;  see  section  2.3.5. 1, 
page  20.  If  the  left  half  of  the  expression  is  non-zero,  the  word  will  be  flagged  as  containing  an 
address  field,  making  another  address  field  illegal. 

Examples: 

MOVE  I  2, -KB)  jassembles  201106  777777 

M0VS1  1 .  ( < JRS T > )  jassembles  205040  254000 


2.1. 2  Halfword  Statement 

EXPR. , ©ADDRESS ( INDEX)  ; COMMENT 

If  an  expression  is  followed  by  comma-comma  (,,),  it  will  be  placed  in  the  left  halfword  of  the 
cuirent  location,  and  FAIL  will  continue  to  piocess  an  address  field,  index  field,  and  indirect  field 
This  is  more  convenient  than  the  XWD  pseudo-op  for  assembling  halfwords  since  it  allows  the 
entire  effective  address  to  be  specified  in  the  usual  way  The  only  restriction  is  to  beware  of 
possible  interpretation  of  the  first  symbol  as  an  opcode.  If  the  expression  followed  by  the  comma- 
comma  is  not  the  first  thing  assembled  in  the  word,  the  warning  message  Illegal  „  will  be  printed, 
although  the  statement  will  assemble  correctly.  This  prevents  confusion  if  an  extra  comma  is 
typed  after  an  accumulator  field. 
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2.1.3  Full-Word  Expression 
EXPR  {COMMENT 

When  the  first  expression  in  a  statement  is  not  preceded  by  a  comma  and  is  not  an  opcode,  FAIL 
assumes  that  the  expression  is  a  full-word  expression.  The  entire  36-bit  value  of  the  expression  is 
placed  in  the  current  word.  The  full-word  expression  is  the  only  ordinary  statement  (i.e.,  not  a 
pseudo-op)  that  assembles  a  single  expression  with  a  full  36-bit  value.  Full-word  expressions  are 
treated  as  address  fields  for  purposes  of  the  multiple  address  field  error 

If  a  full-word  expression  contains  any  undefined  symbols,  unavailable  symbols,  or  strange 
relocation  constants,  the  entire  word  will  be  updated  with  the  value  of  the  expression  when  it 
becomes  known  This  will  obliterate  any  index,  indirect,  or  accumulator  field  appearing  after  the 
expiession  on  the  line  If  the  expression  actually  has  only  an  18-bit  value,  this  can  be  fixed  by 
prefixing  the  expression  with  a  comma  (i.e.,  by  using  a  truncated  expression).  If  a  full-word  value 
is  actually  needed  and  the  problem  is  not  just  one  of  availability  (curable  by  the  use  of  GLOBAL 
or  down-arrow  (4-),  see  section  2  3.4.6,  page  16),  it  may  be  necessary  to  use  an  explicit  expression 
to  set  the  accumulator,  index,  and  indirect  fields. 


2.1.4  Truncated  Expression 

.EXPR  {C'JMMENT 

If  a  comma  appears  before  any  expression  in  a  statement,  it  flags  the  current  word  as  containing 
data  in  order  to  force  a  subsequent  expression  to  be  treated  as  an  address  field  even  when  it  is  the 
only  expression  in  the  statement.  This  can  be  used  to  form  an  18-bit  truncated  expression.  Note 
that  a  statement  consisting  of  a  single  comma  will  assemble  a  zero  word. 


2.1.5  Input-Output  Instruction  Statement 
OPCODE  DEV.aADORESSf INDEX)  -.COMMENT 

An  input-output  instruction  statement  is  used  to  assemble  one  hardware  I/O  instruction.  Most 
parts  are  the  same  as  in  an  instruction  s  atement,  except  that  a  device  selection  field  appears 
instead  of  an  accumulator  field.  Also,  the  opcode  portion  must  be  one  of  the  PDP-IO  hardware 
input-output  instructions  (eg.,  DAT  AO).  N-  tc  that  hardware  I/O  instructions  are  not  related  to 
operating  system  UUOs 


2.1 .5.1  Device  Selection  Field 


The  same  syntax  and  restrictions  that  apply  to  an  accumulator  field  apply  also  to  the  device 
selection  field  The  value  of  the  device  selection  field  is  placed  in  bits  3-9  of  the  current  word. 
This  value  is  often  called  the  device  code. 
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2.1.6  Comment  Field 


When  FAIL'S  statement  processor  encounters  a  carriage  return  or  semicolon  (;),  all  characters  up 
to  the  next  line  feed  or  form  feed  are  completely  ignored  except  for  listing  and  certain  macro 
processor  functions  (see  section  4  1,  page  38).  Upon  reaching  the  line  feed  or  form  feed,  the 
comment  is  terminated  Usually,  this  is  used  to  insert  a  relevant  comment  at  the  end  of  a  line  of 
code 


2.1.7  Statement  Termination 


A  statement  is  terminated  by  a  comment  or  by  any  of  the  characters  line  feed,  double-arrow  («), 
right  bracket  0),  or  right  broket  (>)  when  not  processing  a  comment  When  a  statement  is 
terminated,  the  value  of  the  current  word  (if  any)  is  returned  A  statement  returns  no  value  at  all 
if  no  expressions  appeal  in  it  or  if  it  is  a  pseudo  op  which  assembles  no  code.  Terminating  a 
statement  with  one  of  the  bracket  characters  often  has  special  significance,  as  in  atomic  statements 
or  literals  Double-arrow  can  be  used  for  assembling  more  than  one  statement  on  a  line,  but  will 
not  te-minate  a  comment. 


2.2  Expressions 


Expressions  are  built  fiom  atoms  connected  by  operators  which  allow  the  specification  of  values 
based  upon  arithmetic  and  logical  functions  of  several  values  These  expressions  follow  essentially 
the  same  rules  as  conventional  programming  languages  Each  operand  in  an  expression  may  be 
an  atom,  an  atomic  statement,  or  an  expression  in  parentheses,  preceded  by  any  number  of  unary 
operators.  If  parentheses  are  i^ed,  the  expression  inside  the  parentheses  is  evaluated  before 
performing  any  operations  using  that  operand  If  a  unary  operator  appears,  its  function  will  be 
evaluated  before  any  operations  using  that  operand  (but  after  the  expression  in  parentheses,  if 
parentheses  are  used).  Multiple  unary  operators  are  evaluated  from  right  to  left,  so  --1  is 
processed  as  -(-1)  Finally,  these  operands  can  be  connected  with  binary  infix  operators  whose 
order  of  evaluation  is  determined  by  their  assigned  precedence  levels  (highest  first)  and  is  left-to- 
right  for  operators  of  the  same  level.  An  expression  may,  of  course,  consist  of  a  single  operand 
(i.e.,  atom)  with  no  operators  at  all. 

Surrounding  an  entire  expression  with  parentheses  sometimes  signifies  an  index  field  (see  section 
2.1  1.5,  page  4).  All  arithmetic  is  integer  or  boolean,  no  type  conversion  is  done  for  floating-point 
operands 
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The  following  is  a  list  of  the  available  operators  and  their  precedes  e  levels: 


Symbo 1 

Mean i ng 

Precedence  Leve 

binary  operators 

+ 

Addi t ion 

1 

- 

Subtrac  t i on 

1 

* 

Mu  1 1 i p 1 i cat i on 

2 

/ 

Division 

2 

& 

Log i :a 1  AND 

3 

/V 

Logical  AND 

3 

! 

Logical  OR 

3 

V 

Logical  OR 

3 

0 

Exc 1  us i ve  OR 

3 

i 

Exclusive  OR 

3 

• 

Logical  Left-Shift 

4 

unary  operators 

Negation  (tuo’s  complement) 

5 

- 

Logical  NOT  (one's 

comp  1 ement ) 

5 

If  an  expression  contains  any  undefined  values,  its  own  value  is  undefined.  If  an  expression  is 
used  in  a  context  where  undefined  values  are  legal,  FAIL  retains  a  structure  describing  the 
evaluation  needed,  called  a  Polish  fixup  for  its  similarity  to  Polish  arithmetic  notation,  in  order  to 
complete  the  evaluation  when  (he  unknowns  become  defined.  As  soon  as  all  values  in  the 
expression  are  defined,  a  fixup  will  be  output  (to  the  loader)  to  correct  the  value  (or  the  value  will 
be  corrected  directly  in  the  case  of  a  literal).  If  the  expression  is  not  completely  defined  by  the  end 
of  the  assembly  (due  to  external  references  or  errors),  the  Polish  structure  is  sent  to  the  loader  for 
evaluation  at  load  time.  In  other  words,  the  right  thing  usually  happens  with  a  partially 
undefined  expression  as  long  as  it  is  legal  in  the  context  where  it  is  used. 

Expressions  may  also  begin  with  any  number  of  labels  or  assignment  statements,  which  have  no 
effect  on  the  value  of  the  expression 


Examples 


F00®2 
(BAR-1 >«-2 
(A+2) *B 
- (A+2) *-B 
<A+2>*B 


=60*«G0 
"A" -40 
[01-1 

F00: BAR-1  105 


lvalue  of  F00  shifted  left  2  bits 
lvalue  of  BAR-1  shifted  right  2  bits 

;  same  value  as  above 

; another  way  (The  symbol  A  must 

;be  defined  and  available.  See 

;Atomic  Statements,  section  2.3.5. 1,  page  20) 


i even  literals  can  appear  in  expressions 
; the  value  of  this  expression  is  105 
; (labels  and  assignment  statements  have  no 
leffect  or  the  value  of  the  expression) 


8 


Basic  Syntax 


FAIL 


2.3  Atoms 


An  atom  is  the  most  basic  syntactic  element.  An  atom  is  t.ther  a  symbol  or  a  constant  There  are 
also  complex  atoms  which  are  not  really  atoms  at  all,  but  which  can  be  used  in  the  same  way  as 
atoms  in  forming  expressions  Every  atom  represents  a  value. 


2.3. 1  Identifiers 


Identifiers  are  very  basic  syntactic  Hements.  They  have  many  different  uses,  all  of  which  involve 
referring  to  something  by  a  convenient  symbolic  name  The  uses  of  identifiers  will  be  covered  as 
the  various  applications  arise  Identifiers  may  be  defined  either  by  the  programmer  or  by  FAIL. 

The  characters  legal  in  an  identifier  are  letters,  digits,  and  the  four  characters  dollar  sign  (8), 
percer  sign  (%),  point  (.),  and  underbar  (_V  An  identifier  is  any  non-null  string  of  characters 
from  this  set.  delimited  by  characters  not  from  this  set,  except  that  the  first  character  of  an 
identifier  must  not  be  a  digit.  Only  the  first  six  characters  of  an  identifier  are  significant,  and 
upper  and  lower  case  letters  are  treated  as  equivalent.  Thus  "FOOBAR"  and  ”f  cobarb  I  etch"  are 
equivalent  identifiers  Also,  is  considered  equivalent  to  so,  for  example,  ”A_7“  and  "A.  7" 
are  equivalent  identifiers 

Certain  identifiers  have  special  meaning  in  FAIL,  and  cannot  be  used  except  with  their  own 
special  meanings  Some  of  these  reserved  identifiers  are  IFAVL,  IFDEF,  IFDIF,  IFE,  IFG,  IFCE, 
IFIDN,  IFL,  IFLE,  IFMAC.  IFN,  IFNAVL,  IFNDEF,  IFNMAC,  IFNOP,  IFOP,  IOWD, 
.  FN  AM  I,  .FNAM2,  V.  and  "8.". 


2.3.2  Values 


Most  of  the  normal  assembly  process  consists  of  translating  text  strings  into  their  corresponding 
binary  values  The  main  transformation  happens  when  the  atomic  elements  are  converted  to  their 
binary  representations,  these  are  combined  by  binary  operations  into  more  complex  constructs. 

Often  the  final  36-bit  value  of  an  atom  depends  upon  information  not  available  at  the  time  the 
atom  is  seen  This  value  may  become  known  when  a  later  part  of  the  program  is  assembled,  or  it 
may  not  be  known  until  'he  program  is  actually  loaded.  Consequently,  up  until  the  final  loading 
of  a  program  into  a  cor-.1  image,  its  representation  must  be  a  slightly  expanded  form  of  simple 
bmaiy  so  that  the  steps  necessary  to  complete  the  calculation  of  all  binary  values  can  be 
adequately  desciibed  Partially  defined  values  are  commonly  used  in  writing  FAIL  programs, 
several  mechanisms  exist  to  enable  FAIL  (and  the  loader)  to  handle  such  values  correctly  The 
full  impact  of  forward  references  and  relocatable  values  is  discussed  in  appendix  B,  page  50. 

Some  of  tlm  different  kinds  of  values  that  often  occur  in  FAIL  are  distinguished  by  particular 
names  relocatable,  absolute,  defined,  undefined,  available,  and  unavailable.  The  definitions  that 
follow  >nvolve  symbols  and  block  structure  to  some  extent.  Refer  to  section  2.3  4,  page  II,  and 
section  23.4.6,  page  15,  for  further  elucidation. 
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A  value  that  depends  on  where  the  progtam  is  when  it  is  loaded  in  core  is  called  relocatable 
Relocatable  values  occur  most  frequently  when  some  location  in  the  program  or  in  the  data  is 
referred  to.  Values  that  do  not  depend  on  where  the  program  is  located  are  called  absolute  or 
unrelocatable  An  example  of  an  absolute  value  is  a  constant  Another  example  of  an 
unrelocatable  value  is  the  length  of  a  table  (that  is,  the  difference  between  two  relocatable  values). 

A  symbol  is  an  identifier  that  has  a  value  A  symbol  is  defined  when  a  value  is  assigned  to  it.  A 
symbol  can  be  referenced  before  it  is  defined,  that  is,  when  the  value  of  the  symbol  is  undefined 
FAIL  makes  sure  that  the  right  thing  happens  when  the  value  becomes  defined  as  long  as  an 
undefined  value  is  legal  in  the  particular  context  where  it  is  used 

A  symbol  that  is  defined  is  said  to  be  available  (after  the  point  of  definition)  in  the  block  where  it 
is  defined  When  another  (lower)  block  is  entered,  such  a  symbol  becomes  unavailable  unless  the 
programmer  has  taken  steps  to  force  the  availability  of  that  symbol  in  lower  blocks. 


2.3.3  Constants 


Constants  are  the  simplest  forms  of  atoms;  their  values  do  not  depend  on  context  or  previous 
operations  (with  the  exception  of  the  radix  for  interpretation  of  numbers).  Constants  are  absolute, 
i.e.,  independent  of  where  the  prom  am  is  loaded.  A  constant  may  be  one  of  several  types  of 
numerical  or  text  constants.  In  addition  to  the  atomic  constants  described  here,  there  are  various 
data  entry  pseudo-ops  described  in  section  3.3,  page  30. 


2.3.3.1  Simple  Numbers 


A  simple  number  consists  of  a  string  of  digits,  optionally  followed  by  the  letter  "B"  and  one  or  two 
additional  digits  which  represent  a  scale  factor  The  digit  string  is  interpreted  as  a  number  in  the 
current  radix  Since  the  radix  is  initialized  to  8,  simple  numbers  are  usually  interpreted  as  octal 
by  default  In  this  case,  the  accumulation  is  done  by  logical  shifting,  so  the  number  is  considered 
unsigned.  If  the  radix  is  anything  other  than  S,  the  accumulation  is  done  by  multiplication,  and 
the  sign  bit  cannot  be  set  (but  a  negative  number  can  be  entered  as  an  expression).  The  current 
radix  can  be  set  with  the  RADIX  pseudo  op  (see  section  3.5 4,  page  35). 

The  one-  or  two-digit  argument  following  the  ”B",  interpreted  in  decimal,  specifies  the  low-order 
bit  position  of  the  number  in  the  word  The  number  is  shifted  left  logically  a  number  of  bit 
positions  equal  to  35  (decimal)  minus  the  argument. 

Examples: 

1743 

2 

2S4B8 

1B33  iequivalent  to  4 

22B18 

10B37  iequivalent  to  2 


10 


Basic  Syntax 


FAIL 


2.3. 3.2  Decimal  Numbers 


Decimal  numbers  provide  a  way  of  entering  decimal  information  regardless  of  the  current  radix 
A  decimal  number  is  a  simple  number  preceded  by  sn  equal  sign  (-)  Since  decimal  numbers  are 
handled  identically  to  simple  numbers  except  for  the  radix,  the  "B"  shifting  operation  may  also  be 
used  with  decimal  numbers. 

Examples 


•  100 
-69 

-10B27 


2.3.3. 3  Floating-Point  Numbers 


Numbers  may  also  be  entered  in  standard  floating-point  notation,  in  which  case  they  will  be 
converted  to  PDP-10  single-precision  floating-point  format  Floating-point  numbers  are  always 
interpreted  in  decimal  regardless  of  the  current  radix.  Note  that  any  arithmetic  performed  by 
FAIL  on  numbers  is  always  integer  arithmetic,  even  if  the  operands  are  floating-point  numbers. 

A  floating-point  number  consists  of  two  strings  of  digits,  separated  by  a  decimal  point  and  followed 
by  an  optional  scale  factor  The  digit  strings  before  and  af'er  the  decimal  point  represent  the 
integer  and  fraction  parts  of  the  floating-point  number,  respectively  The  scale  factor  is  the  letter 
"E”,  an  optional  minus  sign,  and  one  or  two  digits.  The  number  following  the  "E"  specifies  a 
power  of  ten  by  which  the  number  will  be  multiplied. 

Although  the  fraction  part  of  the  number  may  be  omitted,  it  is  probably  better  to  include  the 
redundant  0  to  avoid  a  possible  future  conflict  that  could  arise  if  FAIL  were  modified  to  allow  a 
decimal  point  following  a  digit  string  to  signify  a  decimal  number. 

Examples 


10.7E1  ;equivalent  to  107.0 

9.973  1 

0.13 

10.  ibetter  to  write  this  as  10.0 

1 . 86E05 
31 . 41S9E-1 

69E1  ;presently  equivalent  to  690.0 


2.3.3. 4  Ascii  Constants 


Constants  may  also  be  specified  as  the  ascii  value  of  a  character  or  string  of  characters.  The  ascii 
value  of  a  character  is  its  7-bit  code  in  the  Stanford  Character  Set,  a  modified  form  of  the 
USASCII  code  (see  appendix  D.  page  fi6).  An  ascii  constant  is  written  as  a  string  of  characters 
not  containing  a  double  quote  ("),  enclosed  with  double  quotes,  eg,  "Foo".  If  the  string  is  null, 
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le,  the  resulting  value  will  be  zero  If  the  string  contains  exactly  one  character  the  resulting 
value  will  be  the  ascii  value  of  that  character  If  the  string  contains  more  than  one  character, 
each  additional  character  will  shift  the  total  left  7  bits  and  add  its  own  value,  much  as  an  octal 
number  is  accumulated  This  results  in  packing  characters  into  right-justified  7-bit  bytes  Only 
the  low-order  36  bits  of  the  total  are  used,  so  if  more  than  5  characters  appear  in  the  string,  only 
the  last  5  characters  and  the  low-order  bit  of  the  sixth-from-last  character  will  affect  the  value. 

This  right-justified  form  is  not  the  standard  way  of  packing  text  for  addressing  with  byte 
instructions,  but  is  intended  mainly  for  small  immediate  operands,  etc  Text  pseudo-ops  (described 
in  section  3  36,  page  32)  are  used  to  store  text  in  the  usual  left- justified  format  in  multiple 
words. 


Examples: 

101  octal 
27503 

337576130362 


"tC" 

" foobar 


2.3.3. 5  Sixbit  Constants 


Another  character  coci«*  that  is  frequently  used  is  sixbit.  It  is  a  modified  version  of  ascii  code 
which  uses  only  6,  instead  of  7,  bits  in  order  to  pack  6  characters  Into  a  word  rather  than  5. 

The  basic  ascii  to  sixbit  transformation  consists  of  subtracting  40  (octal)  from  the  ascii  code, 
which  maps  ascii  40-137  (all  the  printing  characters  of  64-character  ASCII)  into  the  desired  0-77. 
Since  the  140-177  range  consists  mostly  of  lower-case  versions  of  the  100-137  characters,  a  better 
transformation  also  maps  this  range  to  40-77.  The  method  used  by  FAIL  is  to  copy  the  100  bit 
into  the  40  bit  and  set  the  100  bit  to  0  The  inverse  transformation  is  accomplished  by  adding  40 
to  each  sixbit  character. 

Sixbit  constants  can  be  specified  in  FAIL  in  the  same  way  as  ascii  constants,  except  that  close 
single  quotes  (apostrophes)  (')  should  be  used  instead  cf  double  quotes.  Naturally,  if  more  than 
one  character  appears  in  the  string,  the  shifting  will  be  6  bits  at  a  time  instead  of  7,  and  the  last  6 
characters  of  the  stung  will  always  be  completely  significant.  /*gain,  a  pseudo-op  is  available  (see 
section  3.3.6,  page  32)  to  pack  longer  strings  into  multiple  words 

Examples 


’a’ 

’  DSK 

’ gronker ’ 


41 

446353000000 

625756534562 


2.3.4  Symbols 


Symbols  are  one  of  the  most  important  features  provided  by  an  assembler.  One  crpability 
provided  by  symbols  is  the  ability  to  abbreviate  a  complex  expression  with  a  single  identifier 
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Another  is  lo  lepresent  ai  assembly  parameter,  so  that  its  value  can  be  changed  at  the  symbol 
definition  only,  wthout  having  to  modify  the  places  where  the  parameter  is  used  A  third  use  is 
to  represent  values  which  are  difficult  for  the  programmer  to  calculate,  such  as  values  dependent 
upon  exactly  where  certain  parts  of  the  program  are  stored 

A  symbol  is  an  identifier  which  at  some  point  in  the  program  (or  possibly  in  an  external  program) 
is  assigned  a  value  which  will  be  associated  with  that  identifier  whenever  it  is  used  in  a  context 
wheie  symbols  are  recognized  (see  section  2  I  I  I,  page  3,  and  section  4  14,  page  40,  for 
discussion  of  possible  conflicts  with  opcodes  or  macros)  The  point  at  which  a  value  is  assigned  to 
a  symbol  is  said  to  be  the  point  where  it  is  defined. 

In  most  circumstances  a  symbol  may  be  used  to  stand  for  a  value  either  before  or  after  it  is 
defined  A  symbol  is  said  to  be  icjerenced  when  it  is  used  to  stand  for  a  value  If  this  reference 
occurs  earlier  in  the  source  file(s)  than  the  definition,  it  is  said  to  be  a  Jorruard  reference-,  if  the 
re'eience  follows  the  definition,  it  is  said  to  be  a  backward  reference.  Backward  references  can  be 
handled  fan  ly  easily,  by  merely  replacing  the  symbol  by  its  known  value.  However,  forward 
references  create  some  complication  since  FAIL  does  not  know  the  value  of  the  symbol  until  later 
in  the  file 

Two  pass  assemblers  avoid  the  forward  reference  problem  by  assembling  the  program  twice  On 
the  Pit st  pass  the  assembler  calculates  the  value  for  each  symbol,  on  tae  second  pass  these  known 
values  are  used  when  the  corresponding  symbols  are  referenced  This  method  probably  has  the 
smaller  storage  requirements,  but  it  requires  more  cpu  time  since  the  entire  source  file  is  scanned 
twice 

FAIL  uses  the  one-pass  approach  to  save  execution  time  (at  the  expense  of  increasing  the  storage 
requirements).  In  this  method,  each  forward  reference  assembles  an  incomplete  word,  but 
sufficient  information  is  included  in  the  binary  file  ro  enable  the  load  r  to  complete  the  assembly. 
Part  of  the  necessary  mechanism  exists  in  the  loader  anyway  in  order  to  handle  externally  defined 
symbols,  which  must  be  treated  as  forward  references  even  by  a  two-pas:  assembler.  Information 
placed  in  the  binary  file  to  update  the  value  of  an  incompletely  assembled  word  is  referred  to  as  a 
fixup. 

Because  of  the  problem  of  forward  references  in  a  one-pass  assembler,  the  meaning  of  "defined"  as 
used  in  this  manual  is  not  "defined  somewhere  within  the  program",  but  rather  "defined  in  the 
program  before  the  place  being  considered"  In  this  sense  a  symbol  is  not  considered  to  be 
"defined"  at  the  time  of  a  forward  reference,  even  if  it  is  defined  later  in  the  program. 

A  symbol  may  be  defined  in  cne  of  four  ways  It  may  be  defined  as  a  label,  as  a  parameter,  or  as 
a  variable,  or  it  may  be  a  predefined  symbol.  These  types  of  symbols  are  discussed  in  the 
following  subsections. 


2.3.4. 1  Labels 


Labels  are  the  most  common  type  of  symbol  They  are  used  as  symbolic  references  to  locations  in 
the  program  Labels  help  to  keep  such  references  independent  of  the  exact  placement  of  those 
parts  of  the  program  in  the  core  image.  The  value  of  a  label  is  .alculated  automatically  by  FAIL, 
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so  that  the  programmer  need  not  keep  careful  account  of  the  exact  numeric  locations  of  all  parts 
of  his  program 

A  label  is  defined  by  simply  writing  an  identifier  followed  by  a  colon  (:)  at  the  beginning  of  any 
expression  being  scanned.  This  will  normally  define  the  symbol  as  equal  to  the  location  counter, 
re.,  the  location  where  the  next  word  will  be  assembled  However,  in  some  circumstances 
involving  the  use  of  literals  (section  2.3  5.2.  page  20)  or  the  PHASE  pseudo-op  (section  3.1  3. 
page  23),  the  value  of  me  label  may  differ  from  the  location  counter  The  value  assigned  to  a 
label  is  usually  relocatable  because  the  location  counter  is  initialized  to  relocatable  zero,  but  it  may 
be  absolute. 

Although  labels  may  occur  at  the  beginning  of  any  expression,  they  almost  always  occur  at  the 
beginning  of  a  line  This  convention  improves  the  readability  of  programs  by  keeping  labels  in  a 
place  where  they  are  easily  recognized. 

In  order  to  detect  possible  conflicts  in  label  usage,  FAIL  does  not  allow  any  label  to  be  defined 
more  than  once.  (However,  FAIL  block  structure  allows  a  label  to  be  redefined  in  different  blocks; 
sr  section  2.3 4.6,  page  15)  Once  a  symbol  has  been  defined  as  a  label,  it  cannot  be  redefined,  a 
s  mbol  cannot  be  defined  as  a  label  if  it  has  any  previous  definition  An  attempt  to  do  either  of 
tnese  things  will  result  in  a  multiple  definition  error  message,  and  the  new  definition  will  not  take 
effect. 


Examples: 

LOOP:  JRST  LOOP 

F00: 


ipoints  to  itself 

j  labels  the  location  of  the  next  instruction 


2.3.4. 2  Parameters  (Assignment  .Statements) 


A  parameter  is  a  symbol  that  is  given  an  arbitrary  38-bit  value  by  an  assignment  statement. 
Actually,  the  firal  value  is  36  bits,  but  since  either  IS-bit  halfword  may  be  relocatable  two  more 
bits  are  included  in  the  representation  of  the  value.  The  basic  format  of  an  assignment  statement 
is  an  identifier  followed  by  a  left-arrow  {-)  followed  by  an  expression.  The  38-bit  value  of  the 
expression,  which  must  be  defined,  will  be  given  to  the  specified  symbol.  An  equal  sign  (»)  may 
also  be  used  as  an  alternative  to  left-arrow  to  allow  partial  compatibility  with  other  assemblers, 
but  if  the  first  atom  after  the  ■  begins  with  another  *»  to  indicate  a  decimal  number,  at  least  one 
space  should  separate  the  two  to  distinguish  them  from  =-,  which  has  a  different  function  (see 
section  2  3.4.5,  page  15). 

As  with  labels,  any  number  of  assignment  statements  may  appear  at  the  beginning  of  any 
expression,  but  they  are  normally  written  as  separate  statements  for  improved  readability.  In  its 
full  generality,  an  assignment  statement  may  define  more  than  one  symbol  by  beginning  with 
several  symbol  names,  each  followed  by  a  left-arrow,  and  finally  followed  by  the  expression,  whose 
value  will  be  given  to  all  symbols  mentioned 


Unlike  labels,  parameters  may  be  redefined  as  often  as  desired.  Once  a  parameter  has  been 
defined,  each  reference  to  it  will  use  the  value  in  effect  at  the  time  of  that  reference  (i.e.,  as  of  the 
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,  .  rhp  value  aDDeating  in  the  symbol  table  in  the  binary  output  file  will  be  the  last 

v  ■aluVafsiened  The  value  used  for  forward  references  (i.e.  before  the  first  definition)  will  be  that 
of  the  firs'?  assignment  Note  that  ,h:s  ,s  an  incompatibility  with  two-pass  assemblers,  which  would 
instead  use  the  last  value  assigned  during  pas;  one. 


Examples 


FOO-105 
BAR*— 63 

BLETCH*-BARF-l0SS.-F00+BAR*3 

garp-  -97  mote  space  between  - 


is  necessary 


2.3. 4.3  Variables 


„  ..  whn,P  values  are  the  addresses  of  cells  automatically  allocated  by  FAIL  for 

datastorage  A  variable  is  usually  created  by  immediately  following  a  symbol  reference  with  a 
number  s.ln  (»)  The  symbol,  which  must  not  be  previously  defined,  is  declared  to  be  a  variable 
number  sg(  y  assigned  when  the  location  of  the  variables  area  is  known  (see  section 

t  defined  at  this  point,  ,t  ca  -not  be  used  ,n  contexts  which 

l  1  "■  paS*  ‘ '7,  ‘ rpferences.  However,  it  can  be  used  as  any  other  forward-referenced  symbol; 

the  "number  sign  need  not  be  used  with  more  than  one  occurrence  of  the  symbol.Similareffects 
can  also  be  obtained  with  the  INTEGER  and  ARRAY  pseudo- rps  (see  section  3.4.2.  page  33). 


Examples: 

SE  ZM  F'J0« 

MO  'El  A.BARtf-1 

2.3  4.4  Predefined  Symbols 


Predefined  symbols  are  available  for  use  in  all  circumstances  where  symbols  are  recognized. 

Two  predefined  symbols,  point  (.)  and  dollar-point  («.)  refer  to  the  location  counter,  which  is  the 
^  npxt  romnlete  word  will  be  stored.  In  the  absence  of  special  circumstances,  . 

and  "I""  ha«  the  same  value;  V  is  the  one  usually  used.  These  values  are  usually  relocatable 
but  may  be  absolute,  see  section  3.1.1.  page  22 

-r-i  fm  having  two  of  these  symbols  is  that  some  features  of  FAIL  create  complications 

affecting5  the  location  counter,  see  the  discussion  of  literals  (section  2.3.52,  page  20)  and  the 
PHASE  pseudo-op  (section  3.1  3,  page  23). 


Examples 


JRST  .-1 
JUMPN  T.I.+3 
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The  predefined  symbols,  .FNAdl  and  .  r NAM2  refer  to  the  name  of  the  current  source  file.  The 
value  of  .FNAMI  is  the  36-bit  binary  representation  of  the  source  file  name;  .FNAM2  has  the 
value  of  the  source  file  extension  (or  second  file  name). 


2.3. 4. 5  Half-Killed  Symbols 


Symbols  are  included  in  the  binary  output  file  to  aid  debugging  and  to  allow  the  loader  to  link 
several  programs  together.  The  debuggers  (RAID  and  DDT)  have  symbolic  disassemblers  which 
take  binary  words  and  interpret  their  fields  to  display  mnemonic  opcodes,  addresses,  accumulator 
names,  etc.  Sometimes,  the  user  wants  to  prevent  particular  symbol  names  from  being  displayed 
by  the  symbolic  disassembler  Symbols  that  have  been  marked  to  prevent  their  disp'ay  are  called 
half-killed  Half-killing  a  symbol  is  useful  for  parameters  wh  ch  might  incorrectly  be  displayed  as 
core  addresses  or  accumulator  names  Half-killing  is  also  handy  for  labels  in  code  that  is  relocated 
at  runtime.  The  debuggers  do  recognize  half-killed  symbols  when  they  are  input 

FAIL  treats  half-killed  symbols  precisely  the  same  as  other  symbols,  except,  when  the  symbol  is 
written  in  the  binary  output  file,  a  bit  is  set  to  inform  the  debugger  that  the  symbol  is  half-killed. 

In  FAIL,  half-killing  a  symbol  is  accomplished  by  doubling  the  defining  character  (e.g.,  : or 
--).  In  the  case  of  »«,  the  two  equal  signs  must  not  be  separated  by  any  spaces,  because  this  is 
how  the  amb.guity  is  resolved  with  respect  to  the  other  use  of  equal  sign  to  indicate  decimal 
numbers.  A  parameter  will  be  half-killed  if  any  one  of  its  definitions  specifies  half-killing. 

Examples: 


ERRFLO-100 
I0FLG  <-  -  2000 
BUFSIZ  «  100 
BUFSI2  -  -  100 
BUFSIZ  —  100 
BUFSIZ  —  =  100 
LOOP::  SKIPN  A, (B) 


;  the  usual  way  of  writing  it 

ithis  can  have  spaces  anywhere 

:but  this  can’t  (100  i6  octal) 

jsince  this  means  decimal,  not  half-killed 

jthis  is  unambiguous  (100  is  decimal) 

;  (100  is  decimal ) 

:  a  ha  I f-ki I  led  label 


2.3.4. 6  Block  Structure 


Block  structure  is  very  basic  to  the  usage  of  symbols.  This  section  may  be  skipped  if  the  reader 
does  not  plan  to  use  block  structure  The  one  thing  to  remember  is  that  in  the  absence  of  block 
structure  any  symbol  which  is  defined  is  also  available. 

FAIL  block  structure  provides  a  way  of  localizing  the  usage  of  symbols  to  particular  parts  of  the 
program,  called  blocks.  Block  structure  allows  the  same  symbol  name  to  be  given  different 
meanings  in  different  blocks.  The  block  structure  used  in  FAIL  is  similar  to  that  of  ALGOL,  but 
is  somewhat  less  restrictive 

A  program  is  considered  to  be  a  block  whose  name  is  the  same  as  the  program  name  (set  by  the 
TITLE  statement;  see  section  3.5.1,  page  34).  Each  block  may  contain  any  number  of  inner 
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blocks,  but  the  depth  of  nesting  may  not  exceed  17  (decimal).  A  definition  of  a  symbol,  a  user 
defined  opcode  (see  section  3.2.1,  page  26),  or  a  macro  (see  section  4,  page  38)  applies 
only  within  the  scope  of  the  outermost  block  in  which  it  is  defined.  The  scope  of  a  block  includes 
the  scope  of  each  block  it  contains,  unless  the  symbol  (etc.)  in  question  is  defined  again  in  an  inner 
block,  in  which  case  the  more  local  definition  takes  precedence  within  the  scope  of  that  block.  A 
block  is  delimited  by  a  BEGIN  statement  and  a  BEND  statement  (see  section  3.22,  page  26). 

Features  exist  in  FAIL  for  controlling  the  block  level  of  symbols.  If  a  symbol,  when  defined  as  a 
label  or  parameter,  is  preceded  by  an  up-arrow  (t),  it  will  be  treated  as  if  it  were  defined  in  the 
next-outer  block  If  a  double  up-arrow  (tt)  is  used,  the  symbol  will  be  treated  as  though  it  were 
defined  in  the  outermost  block  of  the  program.  These  features  are  most  commonly  used  for  such 
things  as  making  subroutine  entry  points  available  to  outer  blocks  when  the  subroutines 
themselves  are  contained  in  blocks.  In  simple  cases,  this  could  be  done  by  beginning  the  block 
after  the  entry  label(s)  or  even  after  some  of  the  code,  but  this  makes  reading  the  routine  more 
difficult  and  hence  the  up-arrow  construct  is  preferred.  Tilde  (~)  may  be  used  instead  of  up- 
arrow. 


:  some  examples  of  symbol  usage, 

with  and 

without 

block  structure.  Both  examples 

the  same  code: 

FOOls 

JRST  F001 

FQ01 : 

JRST 

F001 

JRST  F002 

JRST 

F002 

JRST  F003 

JRST 

F003 

JRST  F005 

JRST 

F005 

BEGIN 

F002: 

JRST  F001 

F0022: 

JRST 

F001 

tF003: 

JRST  F002 

F003: 

JRST 

F0022 

JRST  F003 

JRST 

F003 

BEGIN 

JRST  F001 

JRST 

F0013 

MF005: 

JRST  F002 

F005: 

JRST 

F0022 

JRST  F003 

JRST 

F003 

F001: 

JRST  F004 

F0013: 

JRST 

F004 

BEND 

tF004: 

JRST  F004 

F004: 

JRST 

F004 

BENO 

F002: 

JRST  F004 

F002: 

JRST 

o 

o 

A  complication  arises  with  FAIL  block  structure  due  to  the  absence  of  the  ALGOL  requirement 
that  all  identifiers  be  declared  at  block  entry  time.  FAIL  allows  forward  references,  yet  does  not 
require  any  declaration  of  symbols  other  than  their  defining  occurrences.  Hence,  FAIL  cannot 
decide  whether  to  use  an  existing  outer-block  version  of  a  symbol  or  to  make  a  forward  reference 
to  a  more  local  definition  that  may  occur  later. 


To  resolve  this  ambiguity,  FAIL  always  considers  a  symbol  reference  to  be  a  forward  reference 
when  the  symbol  has  not  beer  defined  in  the  current  block,  even  if  it  has  been  defined  in  some 
outer  block  If  no  other  definition  is  given  by  the  time  the  block  ends,  then  the  outer-block 
definition  is  used  to  resolve  the  forward  reference.  While  in  the  inner  block  in  this  situation,  the 
outer-block  symbol  is  still  said  to  be  defined,  but  it  is  also  said  to  be  unavailable  Thus  block 
structure  forces  many  references  to  be  forward  references,  even  when  they  would  not  otherwise  be 
such 
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Macros  and  user-defined  opcodes  cannot/ be  forward-referenced.  Such  symbols  are  always 
available,  references  to  them  will  use  their  outer-block  definitions. 

Examples: 


F00: 

riovsi  1,-62 

F00 

is  def i ned  as  a  1 abe  1 

BAR: 

CAME  2.Z0T (1) 

so  i s  BAR 

AOBJN  1 .BAR 

BAR 

is  referenced 

BEG'N 

F00 

and  BAR  are  defined,  but 

now  unava liable 

LOSS: 

riOVEI  1,0 

LOSS 

i s  def ined 

JRST  LOSS 

a  backward  reference  to  LOSS 

JRST  F00 

th  i  s 

is  treated  as  a  forward 

reference 

F00: 

HRRtl  6, LOSS 

so  i 

t  can  reference  this  definition 

BAZ: 

JRST  BAR 

this 

is  treated  as  a  forward 

reference 

JRST  F00 

thi  s 

refers  to  this  block’s  F00 

BEND 

The 

outer -block  definition  of 

BAR  becomes 

available  at  this  BEND.  A  fixup  is  emitted 
to  fix  the  reference  to  BAR  at  BAZ 


Many  contexts  do  not  accept  forward  references  (eg.,  accumulator  and  index  fields).  In  these 
contexts  unavailable  symbols  cannot  be  used,  even  if  they  are  defined.  Therefore,  FAIL  provides 
two  mechanisms  for  forcing  defined  symbols  to  be  available  to  lower  blocks.  One  is  the  down- 
arrow  mechanism,  which  is  used  at  the  defining  occurrence  of  the  symbol,  and  the  other  is  the 
GLOBAL  pseudo-op  (see  section  3.2.?,  page  26),  which  is  used  in  the  referencing  block. 

The  down-arrow  mechanism  is  the  more  commonly  used  method,  since  this  problem  is  most  often 
associated  with  particular  symbols  (accumulator  names,  assembly  parameters,  etc  ).  Preceding  the 
symbol  name  in  a  label  or  assignment  statement  with  a  down-arrow  (1)  causes  that  symbol  to 
remain  available  whenever  inner  blocks  are  entered.  Usually  it  is  dangerous  to  redefine  such 
symbols  locally,  since  any  forward  references  will  have  incorrectly  referred  to  the  outer-block 
definition.  Consequently  i  warmng  message  is  printed  in  this  case,  but  if  no  forward  references 
are  made  to  the  local  version,  it  will  assemble  correctly.  However,  if  the  redefinition  of  a  dow.i- 
arrowed  parameter  is  effective  at  its  original  block  level  (possibly  via  T  or  Tt),  FAIL  will  change 
the  original  definition  without  complaint.  This  allows  redefinition  of  global  parameters  from 
inner  blocks.  A  quest  on  mark  (?)  may  be  used  instead  of  down-arrow. 
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Examples: 

4A-1 

B«-2 

iFOO*-*-«GS 

BEGIN 

ADD  B.A 
MOVE  A, B 
A«-5 
B*-6 

NOVE  A.B 
TFOO«-*-105 

BEND 


:  some  accumulator  (AC)  definitions 

•.and  a  parameter 

‘.this  is  illegal  because  AC 

•.symbols  must  be  available 

;but  this  is  legal  since  A  is  available 

;  by  ^ 

;this  will  produce  a  message  and  is  too 
:  I  a  t  e  to  affect  the  instruction  above 
;  t  h  i  s  is  legal  and  will  fix  up  the  NOVE 
; to  be  NOVE  1 ,  G 

jwhereas  this  will  be  NOVE  5,6 

;this  is  legal  since  it  is  "aimed"  at  the 

; F00  in  the  outer  block 


There  are  further  details  in  section  32.2,  page  26,  and  section  32.3,  page  26,  about  the 
block  structure  pseudo-ops  BEGIN,  BEND,  and  GLOBAL. 


2.3. 4.7  Linkage  with  Separately  Assembled  Programs 


It  is  sometimes  desirable  to  have  a  program  which  is  assembled  in  several  parts,  either  to  save 
reassembling  the  entire  program  for  each  change  or  because  the  program  is  written  in  a  mixture 
of  languages.  Even  with  a  single  assembly  it  is  usually  necessary  to  use  some  of  the  job  data  area 
symbols,  and  sometimes  symbols  from  the  debuggers  (RAID  or  DDT),  all  of  which  are  reached 
through  the  linking  loader.  In  this  context,  the  word  program  refers  to  the  result  of  one  assembly 
or  compilation,  and  thus  a  core  image  may  contain  several  programs. 

To  allow  reasonable  communication  between  these  programs,  the  loader  allows  symbol  definitions 
to  be  passed  between  programs.  For  this  purpose,  symbols  are  divided  into  two  classes,  local 
symbols  and  global  symbols  (There  is  no  relation  between  the  GLOBAL  pseudo-op  and  the 
global  symbols  discussed  here.) 

Symbols  are  normally  considered  local,  which  means  that  they  will  not  be  available  outside  their 
own  program  and  may  be  defined  in  more  than  one  program  without  conflict.  Global  symbols, 
however,  are  available  to  all  programs  and  hence  must  not  have  conflicting  definitions  within  the 
set  of  programs  to  be  loaded  The  easiest  way  to  declare  a  symbol  to  be  global  is  to  follow  some 
occurrence  of  the  symbol  by  an  up  arrow.  This  flags  the  symbol  as  a  global  without  specifying 
whether  it  is  defined  in  this  program  or  another  program,  since  FAIL  will  have  figured  that  out 
by  the  end  of  the  assembly.  Undefined  globals  (external  symbols)  will  have  appropriate  fixup 
information  passed  to  the  loader  for  resolution  when  the  defining  programs  are  loaded.  Globals 
may  also  be  declared  with  the  EXTERNAL  (section  3.2.5,  page  27)  and  INTERNAL  (section 
3  2  4,  page  27)  pseudo-ops. 
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Declaring  a  symbol  global  forces  its  scope  to  the  outermost  block  in  the  same  way  as  does  a  double 
up-arrow  Therefore,  if  a  symbol  is  defined  and  declared  global  in  an  inner  block,  there  must  not 
be  a  conflicting  definition  in  an  cuter  block. 

One  other  related  fer '.ire  is  the  library  mechanism.  A  library  is  a  file  that  contains  a  set  of  utility 
programs  Each  program  in  the  library  may  be  loaded  independent  of  the  others,  depending  on 
whether  it  is  required  by  the  programs  that  have  been  loaded  thus  far.  To  implement  this,  there 
is  associated  with  each  program  in  the  library  (in  one  or  more  entry  blocks)  a  list  of  certain  global 
entry  points  defined  in  that  program.  In  most  cases  these  are  the  names  of  the  routines  contained 
in  the  program.  When  the  loader  is  in  library  search  mode,  it  loads  only  those  programs  for  which 
at  least  one  of  the  entry  points  corresponds  to  an  existing  unsatisfied  global  request  (external 
symbol)  Only  those  programs  actually  needed  are  loaded  from  the  library;  the  rest  are  ignored. 
The  ENTRY  pseudo-op  (section  3.2.4,  page  27)  is  used  to  declare  symbols  to  be  entry  points 
which  will  be  available  to  a  library  search. 


2.3.4.S  Symbols  and  Arrows 


This  is  a  brief  restatement  of  the  ways  that  identifiers  are  used  as  symbols  in  conjunction  with 
arrows. 


Examples: 

TSYM: 

ttBOL*-«-10 

ttZOT-  -69 

FOOt: 

PUSHJ  P.BAZt 


SYM  is  available  at  the  next-outer  block 
BOL  is  half  killed  and  available  at  the 
outermost  block 

ZOT  is  available  at  the  outermost  block 

A  is  global  and  available  to  loner  blocks 

F00  is  global  and  defined  here  (internal), 

available  at  the  outermost  block 

BAZ  is  global,  may  be  external,  available  at  the 

outermost  block 


2.3.5  Complex  Atoms 


Two  constructs  exist  which  assemble  one  or  more  statements  in  much  the  same  way  as  FAIL’s 
normal  top-level  statement  processor,  but  then  return  as  an  atom  the  value  associated  with  the 
statement(s)  assembled,  rather  than  outputting  the  binary  data.  Both  of  these  constructs  involve 
the  use  of  opening  and  closing  characters  to  delimit  the  text.  For  an  atomic  statement,  broken 
brackets,  called  brokets  (<  and  >),  are  the  delimiters.  For  literals,  the  delimiters  are  square  brackets 
( [  and  ] ). 

When  the  opening  character  is  recognized,  FAIL  saves  its  present  state  and  enters  an  auxiliary 
statement-assembly  loop,  continuing  to  assemble  statements  until  a  statement  is  encountered  which 
terminates  with  the  closing  character.  The  closing  character  is  located  as  a  statement  delimiter,  not 
by  keeping  a  count  of  the  opening  and  closing  characters.  Thus  if  the  delimiter  character  appears 
in  a  text  constant,  it  will  not  be  counted  toward  the  match;  also,  attempting  *o  use  a  comment  (see 
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section  2.1.6,  page  6^  in  the  final  statement  of  the  sequence  will  prevent  recognition  of  the  closing 
delimiter  Note  that  this  method  of  counting  brokets  is  different  from  the  macro  processor,  which 
counts  brokets  rigidly,  independent  of  context.  Nesting  of  complex  atoms  is  handled  by  the 
recursive  nature  of  FAIL’S  statement  processor. 


2.3.5. 1  Atomic  Statements 


When  it  is  useful  to  have  the  value  of  an  entire  statement  treated  as  an  atom,  enclose  that 
statement  in  brokets  Some  number  of  statements  will  be  assembled  as  described  above,  and  the 
value  of  the  first  word  assembled  will  be  returned  a<  the  value  of  the  atom,  just  as  if  the 
corresponding  number  had  been  typed  The  values  of  any  additional  words  assembled  up  to  the 
closing  broket  will  be  ignored,  although  their  side  effects  (if  certain  pseudo-ops  are  used)  may 
remain  For  example,  if  une  of  the  multiple-word  text  pseudo-ops  is  used  inside  brokets,  only  the 
first  text  word  will  be  returned,  and  the  rest  will  be  dispatched  to  the  great  bit  bucket  in  the  sky, 
This  type  of  atom  is  constrained  by  FAIL  to  be  handled  as  a  number,  so  all  symbols  used  in  this 
context  must  be  defined  and  available. 


Examples: 

<JPST> 
<JRST  185 
JRST  BAR 


> 


equivalent  to  254000000000 

254000000105  will  be  the  value 

and  this  statement  won’t  do  anything  except 

possibly  produce  an  error  message  if  BAR 

isn't  defined  and  available  > 

this  broket  will  end  it,  not  the  one  above 


2.3.5.2  Literals 


Although  the  PDP  10  instruction  set  allows  a  large  percentage  of  constants  to  be  specified  as 
immediate  operands,  it  is  still  frequently  necessary  to  reference  constants  stored  elsewhere  in 
memory  Instead  of  explicitly  setting  up  these  constants  and  referencing  them  by  labels,  it  is 
possible  to  reference  these  constants  as  literal s.  The  basic  function  of  literals  is  to  allow  the 
programmer  to  write  the  value  of  the  desired  constant  directly  (i.e.,  literally),  while  the  assembler 
automatically  allocates  a  memory  location  for  it,  stores  the  value  in  It,  and  supplies  the  address  of 
the  cell  for  the  reference  Also,  an  operation  called  constants  optimization  occurs,  which  consists  of 
comparing  (the  binary  value  of)  each  literal  with  previous  literals  to  see  if  the  required  constant 
has  already  been  allocated,  in  which  case  the  existing  cell  will  be  used  rather  than  allocating 
another  This  avoids  multiple  copies  of  a  given  constant. 

To  use  a  literal,  put  a  statement  of  the  desired  value  in  square  brackets  and  use  it  as  an  atom 
The  value  (of  the  literal)  will  be  the  address  of  the  literal  in  memory,  which  is  treated  like  an 
undefined  symbol  since  the  actual  location  will  not  be  assigned  until  later  (usually  the  end  of  the 
orogram,  also,  see  section  3.16,  page  25).  Literals  can  be  used  only  where  forward  references 
are  legal 
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A 


t 


« 


f 


1 


» 


» 


Because  of  the  constants  optimization,  it  is  often  dangerous  (and  considered  poor  form)  to  write  a 
program  which  changes  the  contents  of  a  literal  Such  a  change  affects  all  parts  of  the  program 
attempting  to  use  that  constant,  which  is  not  usually  the  desired  effect. 

A  literal  may  contain  more  than  one  word  if  desired.  The  syntax  of  literals  is  basically  the  same 
as  that  of  atomic  statements,  except  that  all  words  assembled  are  used.  Multiple-word  literals  are 
most  commonly  used  to  store  long  text  strings,  but  may  be  used  to  store  sequences  of  instructions 
There  is  no  rigid  limit  on  the  maximum  size  of  a  literal,  but  large  literals  do  consume  assembler 
core  fairly  rapidly 


For  purposes  of  assembling  code  in  literals,  it  should  be  noted  that  the  predefined  symbol 
retains  its  value  during  the  assembly  of  a  literal,  rather  than  referring  to  the  current  location 
within  the  literal  Thus  it  refers  to  the  location  where  the  reference  to  the  outermost  literal  is 
being  made  The  current  location  within  the  (current)  literal  can  be  referred  to  by  using  the 
symbol  "S. "  (but  this  may  not  do  the  right  thing  if  the  PHASE  pseudo-op  is  in  use) 

Naturally,  labels  may  appear  inside  literals,  but  if  they  do  they  will  be  assigned  the  value  of  the 
current  location  within  the  literal,  rather  than  the  value  outside  (Labels  that  appear  inside 
literals  are  called  literal-labels)  This  is  the  only  time  that  F00:  and  F00-.  assign  different  values 
to  FOG.  The  location  of  a  literal  is  unknown  at  the  time  it  is  processed,  hence,  labels  that  are 
defined  within  literals  (and  "I."  when  used  inside  literals)  are  undefined  symbols.  For  example,  it 
is  illegal  to  say  F00-».  inside  a  literal  because  assignment  statements  do  not  accept  undefined 
values  Note  also  that  constants  optimization  will  still  occur  with  labeled  literals,  and  this  may 
result  in  several  labels  having  the  same  value,  if  appropriate.  7 

Examples: 


PUSH  P. [51 

OUTSTR  (ASCIZ  /FOOBAR/J 
JRST  t  MOVE!  C, 12 

PUSHJ  P.URCH 
SUB  P,  Cl , , 1] 
JRST  .+11 


PUSHJ  P.  [YTST:  CAIEC,"Y" 
CAIN  C, "y" 
AOS  (P) 
POPJ  PJ 


?no  PUSH1,  bo  a  literal  is  handy 
ia  two-word  text  constant 
! some  code  in  a  I i ter a  I 

; a  nested  I i tera I 

{returns  to  the  next  instruction 

i outside  the  I  i  tera I 

;a  subroutine  in  a  literal 
{(very  rarely  done  actually) 


PUSHJ  P, YTST 


!  cal  ling  the  above  subroutine 
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3.  Pseudo-Ops 


Most  statements  are  translated  into  operations  for  the  computer  to  perform  when  the  program  is 
executed  Pseudo-ops  (short  for  pseudo-operations),  on  the  other  hand,  signify  operations  to  be 
per  ormed  at  assembly  time  Some  of  these  operations  affect  the  behavior  of  the  assembler  in 
particular  ways,  others  serve  as  convenient  methods  of  entering  data  in  commonly  used  formats 


3.1  Destination  of  Assembled  Code 


The  assembler  uses  a  location  counter  to  keep  track 
will  go  This  counter  is  initialized  to  relocatable  0 
by  1  for  each  instruction  assembled  The  value  in 
next  word  assembled  will  go 


of  the  location  where  the  code  it  is  assembling 
at  the  start  of  the  assembly,  it  is  incremented 
the  location  counter  is  the  location  where  the 


3.1.1  LOC.  RELOC.  and  ORG 


The  contents  of  the  location  counter  can  be  changed 
statements. 


with  the  LOC,  RELOC,  and  ORG 


T-he  Inin  nfTor°P  IakeS  T  arg,ument'  an  exPress'°n.  which  must  be  defined  and  available 
The  effect  of  LOG  is  to  put  the  value  of  the  expression  into  the  location  counter  and  to  set  the 
relocation  of  the  counter  to  absolute,  regardless  of  the  relocation  of  the  argument 


The  RELOC 
to  relocatable, 


statement  has  the  same  effect  as  the  LOC  statement  except  that  the  relocation 
regardless  of  the  relocation  of  the  argument 


is  set 


The  ORG  statement  has  the  same  effect  as  the  LOC  and  RELOC  statements 
relocation  is  set  to  the  relocation  of  the  argument. 


except  that  the 


Whenever  LOG  RELOC.  or  ORG  is  used,  the  current  value  (and  relocation)  of  the  location 

LOC  RE  LOG  oeprS  V  °nC  SUCh  S3Ved  '°Catl0n  C°Unter'  ™  oru‘  for  each  Pseudo-Op)  A 
hp°^’  RE  OC-°RG  Statement/Wlth  argument  will  cause  the  saved  value  and  relocation  to 
be  swapped  with  the  current  value  (and  relocation)  of  the  location  counter. 


3.1.2  SET  and  USE 


It  IS  possib  e  to  have  multiple  location  counters  and  to  switch  back  and  forth  among  thei 
the  currently  active  location  counter  is  incremented  Location  counters  may  be  given  an 

which  fit  the  syntax  of  ident.fters  Theie  is  no  relationship  between  location  counters  ar 
with  the  same  name 


Only 

names 

labels 
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The  SET  pseudo-op  is  used  to  initialize  a  location  counter.  It  takes  two  arguments  separated  by  a 
comma  The  first  is  the  name  of  the  location  counter;  the  second  is  the  value  to  which  the  counter 
will  be  set  SET  has  the  same  effect  as  ORG  except  that  it  changes  t’ne  indicated  location  counter 
and  has  no  effect  on  the  current  location  counter  unless  it  is  the  same  as  the  indicated  one  SET 
is  usually  used  to  create  a  new  location  counter. 

The  USE  pseudo  op  is  used  to  change  location  counters.  It  takes  one  argument,  the  name  of  the 
location  counter  to  change  to  USE  causes  the  current  location  counter  value  to  be  saved  away 
and  the  value  of  the  indicated  counter  to  be  used.  If  a  subsequent  USE  indicates  the  location 
counter  which  was  saved  away,  the  value  it  had  when  it  was  saved  away  will  become  the  current 
value  If  the  indicated  location  counter  has  not  appeared  in  a  SET  before  its  appearance  in  a 
USE  (i.e.,  if  it  has  no  value),  it  will  be  given  the  value  of  the  current  location  counter.  The 
location  counter  which  the  assembler  starts  with  has  a  blank  name  (i.e.,  a  null  argument  indicates 
this  first  one). 

In  the  example  below,  a  close  single  quote  (apostrophe)  (’)  is  used  to  denote  that  the  value  it 
follows  is  relocatable.  This  is  the  convention  that  FAIL  uses  wher.  making  a  listing  of  the 


assembled  code. 

Example: 

Locat i on 

1 nstruct i ons 

0' 

JRST  F00 

1’ 

JRST  BAZ 

?• 

SET  G ARP,, 37 

2' 

USE  GARP 

37 

JRST  F00 

40 

USE 

2’ 

JRST  F00 

3.13  PHASE  and  DEPHASE 

It  is  sometimes  desired  to  assemble  code  in  one  place  which  will  later  be  moved  by  the  program 
itself  to  another  place.  In  this  case,  it  is  desired  that  labels  be  defined  as  referring  to  locations  in 
the  place  where  the  code  will  be  moved,  rather  than  where  the  assembler  will  put  it.  To 
accomplish  this,  me  PHASE  pseudo-op  is  used  PHASE  has  one  argument,  the  location  to  which 
the  next  word  assembled  will  be  moved  by  the  program.  For  instance,  if,  while  the  location 
counter  is  at  74,  a  PHASE  32  appears  and  a  label  appears  on  the  next  line,  the  label  will  be  given 
the  value  32,  but  the  code  on  that  line  will  be  placed  in  location  74.  Under  these  circumstances, 
the  symbol  will  have  the  value  32,  but  the  symbol  will  have  the  value  74.  The  PHASE 
pseudo-op  remains  in  effect  until  cancelled  by  a  DEPHASE  pseudo-op  (no  argument). 

If  a  RELOC,  LOC,  or  ORG  pseudo-op  (see  section  3  11,  page  22)  appears  while  PHASE  is  in 
effect,  the  following  considerations  apply  If  the  relocation  of  the  location  counter  remains 
unchanged  by  the  RELOC  (or  LOC  or  ORG),  then  the  value  of  the  phase  will  be  offset  b  the 
same  amount  as  the  location  counter  changes.  That  is,  the  value  of  and  will  be  changed 
by  the  same  amount  If  the  relocation  of  the  location  counter  changes  and  the  relocation  of  the 
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phase  was  the  same  as  the  relocation  of  the  (old)  location  counter,  then  the  relocation  of  the  phase 
will  be  changed  and  the  phase  will  be  offset  by  the  same  amount  as  the  location  counter  changes 
Otherwise,  the  error  message  Indeterminate  Phase  due  to  RELOC  will  occur  and  FAIL  will 
dephase 


3.1.4  HISEC 


This  statement  outputs  information  directing  the  loader  to  load  the  program  into  the  high 
segment  It  should  appear  before  any  code  is  assembled. 


3.1  5  TWOSEG 


This  statement  directs  FAIL  and  the  loader  to  assemble  and  load  a  two-segment  program.  This 
complicates  the  relocation  process  because  the  loader  must  maintain  two  relocation  constants,  one 
for  each  segment  Since  only  one  bit  of  -elocation  information  is  available  for  each  value  in  the 
relocatable  binary  file,  a  kludge  is  used  to  decide  which  relocation  to  apply  to  each  relocatable 
value.  To  do  this,  the  loader  compaies  the  unrelocated  value  to  a  quantity  known  as  the  high- 
segment  oiigin,  which  is  the  first  address  used  for  the  high  segment  within  that  program  Any 
value  greater  than  or  equal  to  this  quantity  will  be  considered  a  high-segment  address,  while  any 
value  less  than  this  quantity  will  be  considered  a  low-segment  address.  When  the  value  in 
question  is  a  location  specifier,  the  choice  of  relocation  will  determine  which  segment  the  code  is 
actually  loaded  into. 

Unfoitunately,  there  is  a  possible  bug  in  this  relocation  method.  It  is  possible  to  have  an 
expression  which  evaluates,  through  normal  relocation  arithmetic,  to  a  relocatable  quantity  whose 
unrelocated  value  does  not  correspond  to  the  segment  the  relocation  was  originally  derived  from. 
For  example,  if  FOO  is  a  label  at  high  segment  location  120,  it  will  probably  have  a  value  of 
relocatable  400120.  The  expression  FOO-400000  would  be  calculated  by  FAIL  to  have  the  value 
relocatable  120  This  value  would  be  passed  directly  to  the  loader  since  Polish  appears 
unnecessary.  However,  the  loader  would  apply  the  low-segment  relocation  to  this  value  and 
probably  have  incorrect  results  At  present,  the  best  way  to  get  around  this  is  to  say 
F00*1  -400000,  which  will  force  the  Polish  to  be  passed  to  the  loader. 

The  lugh-segment  origin  is  specified  by  an  optional  argument  to  the  TWOSEG  pseudo-op,  or  set 
to  the  default  of  400000  in  its  absence  In  this  case  a  RELOC  400000  followed  by  a  RELOC  0  will 
initialize  the  dual  location  counter  to  assemble  into  the  low  segment  and  to  switch  segments 
whenever  a  RELOC  statement  with  no  argument  is  encountered  (see  section  3. 1  I,  page  22).  Like 
HISEG,  TWOSEG  should  be  used  before  any  code  is  assembled. 
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Example: 

TITLE  EXAMPLE 
PDLEN«-«-100 
P«- 1 7 

TUOSEG  400000  ; initialize  to  two  segments 

RELOC  0  ;  initial i ze  dual  location  counters 

RELOC  400000  snow  assemble  code  in  the  high  segment 

STARTi  TDZA  1,1 
MOVNI  1,1 
MOVEM  l.RPGSU# 

CALL  I  0 

MOVE  P,  UOUD  PDLEN .  POL  1ST] 

RELOC  iset  the  relocation  to  low  segment 

POL  I  ST i  BLOCK  POLEN  ; define  space  for  data  storage 

RELOC  ;  set  location  counter  to  the  high  segment 

PUSHJ  P, COR  INI  ;code  is  assembled  in  the  high  segment 
; the  rest  of  the  program  goes  here 
RELOC  ; back  to  the  low  segment 

VAR  ;do  variables  in  the  lou  segment 

RELOC  ;  to  the  high  segment 

LIT  sand  literals  here 

END  START 


3.1.6  LIT 

The  LIT  statement  causes  all  previously  defined  lite*  Is  to  be  placed  where  the  LIT  statement 
occurs.  The  LIT  statement  must  not  appear  inside  a  literal.  If  a  two  segment  sharable  program  is 
being  assembled,  LIT  should  appear  in  the  upper  segment. 

3.1.7  VAR 


The  VAR  statement  causes  all  variables  which  appeared  with  a  tt  in  this  block  (or  a  sub-block  of 
this  one)  to  be  placed  where  the  VAR  appears.  VAR  must  not  appear  inside  a  literal.  If  a  two 
segment  sharable  program  is  being  assembled,  VAR  should  appear  in  the  lower  segment. 
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3.2  Symbol  Modifiers 


The  pseudo-ops  in  this  section  perform  several  functions,  all  relating  to  the  definition  or 
availability  of  symbols,  or  affecting  the  linkage  of  this  program  to  others. 


3.2.1  OF  DEF 


The  OPDEF  statement  has  the  following  form: 

OPDEF  symbol  [value! 

OPDEF  inserts  the  symbol  into  FAlL’s  opcode  table  with  the  indicated  value.  The  symbol,  which 
is  a  user-defined  opcode,  mav  then  be  used  as  any  other  opcode.  The  value  part  of  the  OPDEF 
must  be  defined  and  available.  User-defined  opcodes  are  sometimes  called  opdefs  because  of  the 
pseudo-op  by  which  they  are  defined. 


3.2.2  BEGIN  and  BEND 


The  BEGIN  statement  is  used  to  start  a  block.  The  block  it  starts  will  end  at  the  corresponding 
BEND  statement.  The  BEGIN  may  be  followed  by  an  identifier  that  will  be  used  as  the  name  of 
that  block  DDT  and  RAID  recognize  block  names.  If  no  identifier  appears,  the  assembler  will 
create  one  of  the  form  A.  000,  where  the  000  will  be  replaced  by  the  block  number  of  this  block  in 
octal  (The  block  number  is  initialized  to  zero  and  incremented  for  each  BEGIN.)  There  is  no 
relationship  between  labels  and  blocks  with  the  same  name.  All  text  following  the  identifier  is 
ignored  until  the  next  line  feed  or  double-arrow. 

BEND  may  be  followed  by  an  identifier  which,  if  present,  is  compared  to  the  block  name  of  the 
block  being  ended,  if  they  don't  match,  FAIL  prints  an  error  message. 

FAIL  does  not  requi  e  block  names  to  be  unique,  however,  the  loader  and  the  debuggers 
sometimes  depend  on  unique  block  names,  so  the  user  would  be  wise  to  avoid  conflicts. 

For  a  discussion  of  blocK  structure,  see  section  2.34,6,  page  15. 


3.2.3  GLOBAL 


The  GLOBAL  pseudo-op  should  be  followed  by  a  list  of  symbols  separated  by  commas.  Each 
symbol  should  be  defined  in  an  outer  block  The  effect  of  GLOBAL  is  to  find  the  nearest  outer 
block  in  which  that  symbol  is  defined  and  to  make  the  definition  in  that  block  immediately 
available  in  the  block  in  which  the  GLOBAL  appears.  GLOBAL  does  not  affect  the  definition  of 
the  symbol  in  any  intervening  blocks. 
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If  a  symbol  has  been  declared  GLOBAL  in  a  block  and  later  is  redefined  in  that  block,  the 
redefinition- affects  the  definition  in  the  outer  block  where  GLOBAL  found  the  original  definition 
Doing  this  causes  strange  effects  if  the  definition  was  not  in  the  next-outer  block;  it  should  not  b? 
done  without  some  careful  thought. 

The  GLOBAL  pseudo-op  has  no  relation  to  the  concept  of  global  symbols 


3.2.4  INTERNAL  and  ENTRY 


These  statements  declare  certain  locally  defined  symbols  to  be  internal  symbols.  Internal  symbols 
are  those  which  are  made  available  to  other  programs  by  the  loader  INTERNAL  (or  ENTRY) 
should  be  followed  by  a  list  of  symbols  separated  by  commas.  These  symbols  need  not  be  defined 
before  the  INTERNAL  (or  ENTRY)  statement  appears,  but  they  must  be  defined  by  the  end  of 
the  program 

ENTRY  emits  special  library  entry  blocks  to  the  loader;  see  section  2.34.7,  page  19  ENTRY 
statements  must  appear  before  any  other  statements  that  emit  code,  except  that  it  is  specifically 
legal  to  precede  ENTRY  statements  by  a  TITLE  statement. 


3.2.5  EXTERNAL 


The  EXTERNAL  statement  declares  that  certain  symbols  are  external  symbols.  An  external 
symbol  is  a  'ymbol  that  is  declared  internal  in  some  other  program.  EXTERNAL  is  followed  by  a 
list  of  symbols  separated  by  commas  The  loader  will  fix  up  any  references  to  an  external  symbol 
when  the  program  in  which  it  is  defined  is  loaded 

Symbols  must  not  be  defined  at  the  time  they  are  declared  with  an  EXTERNAL  statement.  If  an 
external  symbol  is  subsequently  defined,  it  is  automatically  converted  to  an  internal  symbol. 

If  any  occurrence  of  a  symbol  is  immediately  followed  by  an  up-arrow  (t),  that  symbol  is  made 
external  if  it  is  not  yet  defined,  or  internal  if  it  is  defined  If  an  external  symbol  is  subsequently 
defined,  it  will  be  made  internal. 


3.2.6  LINK  and  LINKEND 


LINK  and  LINKFND  are  used  to  establish  a  single-linked  list  among  several  separately 
assembled  programs  Each  linked  list  is  identified  by  a  link  number  in  the  range  1-20  (octal) 
The  formats  are 

L I NK  number , I  oca  t i on 
LINKEND  number , I ocat i on 
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The  number  is  the  link  number;  the  location  is  the  address  where  the  link  information  will  be 
stored  The  effect  is  to  allow  20  lists  to  be  threaded  through  several  separately  assembled 


The  loader  initializes  each  link  (and  Imkend)  to  zero,  LINK  N.F00  causes  the  loader  to  store  in 
FOO  the  current  value  of  link  N  Then  link  N  is  set  to  (point  at)  FOO.  LINKEND  N  BAZ  causes 
the  the  loader  to  store  the  address  BAZ  as  the  Imkend  for  link  N.  When  the  loader  finishes 
load.ng  all  programs,  the  final  value  of  each  link  will  be  stored  in  the  corresponding  Imkend 
address,  only  if  that  address  is  non-zero.  The  LINKEND  feature  allows  the  head  of  the  list  to  be 
in  a  known  place,  rather  than  in  the  last  place  LINKed. 


3.2.7  .LOAD  and  .LIBRARY 


The  LOAD  pseudo-op  causes  the  loader  to  load  a  specific  REL  file  as  a  consequence  of  loading  the 

program  in  which  this  pseudo-op  occurs.  The  format  is 


.LOAD  DEV; FILE  [PRJ.PRGJ 

The  DEV;  field  is  optional  (the  default  is  OSK:),  it  specifies  the  device  where  the  REL  file  can  bp 

found  The  (PRJ.PRGJ  field  is  optional,  it  has  the  usual  meaning.  The  file  named  must  have  the 
extension  REL  (this  is  a  loader  restriction). 


In  non-Stanford  FAIL  installations,  the  file  name  is  scanned  in  accordance  with  the  convention 
that  prevails  at  that  site 


The  LIBRARY  pseudo-op  is  similar  to  LOAD,  except  tha  instead  of  loading  the  file  the  loader 
will  search  the  named  file  as  a  library. 


3.2.8  PURGE 


The  PURGE  pseudo-op  takes  a  list  of  symbols,  separated  by  commas,  as  its  argument  Each  of 
the  symbols  named  will  be  purged,  le,  removed  from  FAIL’s  symbol  table.  A  purged  symbol  can 
be  an  opcode,  macro,  label  or  other  symbol.  For  PURGE  to  be  legal,  the  symbol  must  be  defined 
and  available  when  the  PURGE  occurs  Some  symbols,  such  as  variable  names  literal-labels  and 
global  symbols,  cannot  be  purged.  Purged  symbols  are  not  passed  to  the  loader  or  debugger 


PURGE  searches  the  symbol  table  for  opcodes  first,  then  macro  names,  and  finally  labels  (and 
parameters)  This  means  that  if  a  symbol  has  a  definition  as  both  an  opcode  and  a  label  purging 

rhat  symbol  will  delete  the  opcode,  and  a  second  purge  of  that  symbol  will  delete  the  label 
definition 


If  the  identifier  name  of  some  purged  symbol  is  used  after  the  purge,  FAIL  makes  a  new  and 
totally  different  symbol,  which  has  no  relation  to  the  purged  symbol.  The  CREF  program  will 
also  consider  such  a  symbol  to  be  different  from  the  purged  symbol. 
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Caution  if  an  opcode  pseudo-op,  or  other  predefined  symbol  is  purged,  it  will  remain  unavailable 
to  subsequent  assemblies  performed  by  the  FAIL  core-image  from  which  it  was  purged  Also  it  is 
unwise  to  purge  a  macro  while  it  is  being  expanded.  v  6 


3.2.9  XPUNGE 


XPUNGE  is  used  to  delete  all  local  symbols  from  one  block 
next  BEND  (or  END  or  PRCEND)  statement  following  the 
local  symbols  will  not  be  emitted  to  the  loader.  This  decreases 
loading  it  faster.  Block  names,  internal  and  external  symbols, 
passed  to  the  loader 


XPUNGE  takes  efifect  only  at  the 
XPUNGE  At  that  BEND,  most 
the  size  of  the  REL  file  and  makes 
variables,  and  literal-labels  will  be 


3.2.10  SUPPRESS  and  ASUPPRESS 


When  a  parameter  file  (i.e..  a  file  that  contains  assembly  parameters  for  use  in  several  assemblies) 
is  used  in  assemblies,  many  symbols  get  defined  but  art  never  used.  Unused  defined  symbols  take 

SUPPRFsVnr  A^,]Ppfip  r«nUSediymb0lS  ??  bP  rem0Ved  fr0m  Symb0'  tab,eS  by  means  0f  the 
SUPPRESS  or  ASUPPRESS  pseudo-ops  These  pseudo-ops  control  a  suppress  bit  associated 

with  each  symbol;  if  the  suppress  bit  is  on  and  the  symbol  is  not  referenced,  the  symbol  will  not  be 
output  to  the  binary  file.  7 

SUPPRESS  takes  a  list  of  svmbols,  separated  by  commas,  as  its  argument.  The  suppress  bit  is 
turned  on  for  each  symbol  named.  A  symbol  may  be  an  opdef,  a  parameter,  or  a  label  The 
symbol  should  be  defined  before  the  SUPPRESS  statement  occurs. 

ASUPPRESS  turns  on  the  suppress  bit  for  every  user-defined  symbol  and  opcode  that  exists  in 

the  symbol  table  at  the  time  the  ASUPPRESS  occurs. 

Variables,  literal-labels,  internals,  and  entry  point  symbols  are  never  suppressed.  Externals  that 
are  not  referf-nced  can  be  suppressed 

If  ASUPPRESS  appears  in  a  universal  program  (see  section  3.2.11.  page  29),  then  all  svmbols 

snEARCHVerSal  S,mb°'  ,ab'e  Wl"  haV'  'he  SUPPrE“  b"  S"  When  ‘hey  art  U!ed  a  sequent 


3.2.11  UNIVERSAL  and  SEARCH 


The  UNIVERSAL  pseudo-op  has  the  same  syntax  as  TITLE  (see  section  3.5  1  page  34)  In 
addition  to  the  functions  of  TITLE,.  UNIVERSAL  declares  the  symbols  defined  in  thfs  program 
to  be  universal  symbols  Universal  symbols  are  symbols  which  can  be  accessed  by  other  programs 
that  are  assembled  after  the  universal  symbols  have  defined.  That  is,  UNIVERSAL  causes 
symbols  to  be  retained  by  FAIL  after  it  finishes  assembling  the  universal  file  When  subsequent 
files  are  assembled  (using  this  copy  of  FAIL,  which  has  the  universal  symbols),  the  universal 
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symbols  can  be  accessed  a{  any  other  local  symbols  The  program  name  set  by  UNIVERSAL  is 
used  to  name  the  universal  symbol  table  created  to  contain  the  universal  symbols  defined  by  this 
prograr  Only  outer  block  symbols  (and  macros  and  opdefs)  are  retained  in  the  universal  symbol 
table  Variables,  literal-labels,  and  internal  symbols  are  not  retained. 

Universal  files  are  intended  for  making  definitions,  not  for  assembling  code  The  usual  use  for  a 
universal  file  is  to  define  opcodes,  macros  and  parameters  for  subsequent  assemblies.  It  is  not  wise 
to  include  relocatable  symbols  in  the  universal  fi'e.  The  exception  is  that  a  universal  file  may 
declare  a  symbol  to  be  external,  that  declaration  can  be  used  by  subsequent  assemblies  that  search 
this  universal  symbol  table 

SEARCH  controls  access  to  the  universal  symbols  SEARCH  takes  a  list  of  arguments,  each  of 
which  is  the  name  of  a  universal  symbol  table.  For  each  universal  table  named,  all  the  symbols  in 
that  table  are  added  to  the  end  of  the  main  symbol  (ur  macro  or  opcode)  table.  Then,  when  the 
symbol  table  is  searched,  if  there  is  no  other  definition  of  the  symbol,  the  universal  definition  will 
be  found.  Universal  symbols  are  considered  to  be  defined  a‘  the  outer  block.  If  such  symbol,  are 
to  be  made  available  to  inner  blocks,  they  must  be  defined  with  a  down-arrow,  or  declared 
GLOBAL 


3.3  Entering  Data 


3.3.1  DEC  and  OCT 


The  DEC  and  OCT  statements  both  take  a  string  of  arguments,  each  a  number,  separated  by 
commas.  The  radix  is  temporarily  set  for  this  one  statement  to  10  for  DEC  or  to  8  for  OCT. 
The  numbers  are  placed  in  successive  locations. 

Examples 


OEC  5.9,4096 
OCT  5,11,10080 


jassembles  three  words 
saseembles  the  same  three  words 


3.3.2  BYTE 


The  BYTE  statement  is  used  to  enter  bytes  of  data.  Arguments  in  parentheses  indicate  the  byte 
size  'o  be  used  until  the  next  such  argument.  The  first  aigument  of  a  BYTE  statement  must  be  a 
byte  size  argument  Other  arguments  are  the  byte  values  An  argument  may  be  any  expression 
that  is  defined,  available,  and  absolute.  Arguments  in  parentheses  (byte  size)  are  interpreted  in 
decimal  (base  !C)  and  other  arguments  in  the  prevailing  radix  Bytes  are  deposited  with  the  byte 
instructions,  so  if  a  byte  will  not  fit  in  the  current  word,  it  will  be  put  in  the  left  part  of  the  next 
word  Unused  parts  of  words  are  filled  with  zeros  Byte  size  arguments  are  not  surrounded  by 
commas,  but  other  arguments  are  separated  by  commas  For  instance,  the  statement 
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BYTE  (7)  3,5(11)6 

will  put  two  7-bit  bytes  (3  and  5)  and  an  I  l-bit  byte  (6)  in  a  word,  left  justified. 

Two  successive  delimiters,  i.e,  two  commas  or  a  comma  and  parenthesis,  indicate  a  null  argument, 
which  is  the  same  as  a  zero. 


3.3.3  POINT 


The  POINT  pseudo-op  assembles  a  byte  pointer  in  one  word.  The  first  argument  should  be  an 
expression  and  is  interpreted  in  decimal.  The  expression  must  be  defined  and  available.  It 
indicates  the  byte  size,  and  its  value  is  placed  in  the  size  field  of  the  assembled  word  The  second 
argument  should  contain  one  or  more  of  an  index  field,  an  address  field,  and  an  at-sign  The 
third  field,  if  present,  indicates  the  bit  position  of  the  low  order  bit  of  the  byte,  i.e.,  its  value  is 
subtracted  from  35  (decimal)  and  olaced  in  the  position  field.  It  is  interpreted  in  decimal  and 
must  be  available.  If  the  third  argument  is  omitted  (no  comma  should  be  present  after  the  second 
argument),  the  position  field  is  set  tc  36  (decimal)  so  that  the  fir*!  time  the  pointer  is  incremented, 
it  will  point  to  the  first  byte  of  the  ward. 


3.3.4  XWD 


The  XWD  statement  takes  two  arguments,  separated  by  a  comma,  and  assembles  a  single  word 
with  the  value  of  the  first  argument  in  the  left  half  and  the  value  of  the  second  argument  in  the 
right  half.  Both  arguments  must  be  present. 


3.3.5  IOWD 


IOWD  is  a  permanently  defined  macro  (see  section  4,  page  38).  Its  definition  is 

DEFINE  I0U0  (A.B) 

-  XUD  - (A) , B-l  > 

IOWD  takes  two  arguments  and  assembles  a  word  in  which  the  negative  of  the  first  argument 
goes  in  the  left  halfword  and  one  less  than  the  value  of  the  second  argument  goes  in  the  right 
halfword.  This  format  (i.e.,  negative  word  count,  and  memory  address  minus  I)  is  often  used  in 
communicating  with  the  operating  system  to  specify  the  address  and  length  of  a  data  block.  Also, 
IOWD  may  be  used  to  initialize  an  accumulator  for  use  as  a  push  down  pointer. 
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3.3.6  ASCII,  ASCIZ,  ASCID,  and  SIXBIT 


There  are  four  text  statements:  ASCII,  ASCIZ  ASCID  and  ciy  tut  r,  u  ►  , 

*  *«7  -  ^ 

charac  er  which  serves  as  a  delimiter.  This  del, miter  should  not  be  any  one  of  the  character's  Hi 
arrow  (*),  colon  (: ),  up-arrow  (t),  tilde  (*),  or  number  sign  (ft).  characters,  left- 

ASCII  puts  the  7-bit  representation  of  each  success, ve  character  in  the  string  (excluding  rh* 
delimiters)  in  success, ve  words,  5  characters  per  word,  until  the  string  is  eZ  pd  t  g  , 
order  bit  of  each  word  and  the  left-over  part  of  the  last  word  are  filled  with  zero 

ASCIZ  is  the  same  as  ASCII  except  that  if  the  last  character  is  the  5th  of  a  wnrH  a  t 

IS  added  a,  the  end.  Thts  I,  to  ensure  that  there  ,s  a,  teas,  o^e  0  by,,  a,°L  end  "r° 

ASCIP,  “°rks  as  AStC"  ““P1  tha'  >•«  l»»  order  bi,  of  each  word  generated  is  a  I  ASCm 

assembles  data  suitable  for  either  the  III  or  Data  rw  riie„i,.,  .  ,s  a  l.  ASCID 

ASCID  format  is  used  for  line  numbers  ,n  the  SOS  editor.  P  "  ^  A'S°-  the 

SIXtB!TcW°rkS  35  ASCH  6XCept  that  Che  characters  ^e  converted  to  the  sixbit  reoresentatmn  and 
packed  6  to  a  word,  The  last  word  ,s  filled  out  with  zeros  ,f  necessarv  A<ri  rr> 

converted  to  sixbit  by  replacing  the  40  bit  with  the  100  bit  and  removing  the  100  bit 


3.3.7  RADIX50 


This  pseudo-op  takes  two  arguments,  separated  by  a  comma.  The  first  argument  is  a  number-  rh* 
second  argument  is  an  identifier.  The  value  assembled  bv  the  RAnrvim  f  ►  number,  the 

representation  of  the  identifier.  w„h  the  nunT ORed ’In'S the' ¥h*.r?£? 
order  bits  of  the  number  are  cleared  before  ORing  “  '  The  ^  ow‘ 

RadMO  ,s  the  representat.on  used  for  symbol  names  in  the  loader,  DDT  and  RAID  RaHiv^n  • 
used  to  condense  6-character  symbols  into  32  bits  Leeal  character  are  red  nr  dr  ^adl*50  ** 

range  0-47  octal  The  rad,x50  value  ,s  obtained^ ?y  aou^Siri  th<? 

character  value  times  a  weight.  The  weight  is  the  power  of  50  L-ran  r  C°mpos,ed  of  each 
character  position  The  weight  of  the  rightmost  non-blank  character  is  °he  Scond'T  “  In' 

IS  W'eht  50,5ft  ~  The  — r— “  between  cbatal 


B  I  ank 

0-9 

A-Z 


0 

1-12 

13-44 

45 

4G 

47 
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3.4  Reserving  Space  for  Data 


3.4.1  BLOCK 


The  BLOCK  statement  is  used  to  reserve  a  storage  area  for  data.  The  value  of  the  argument  is 
added  to  the  location  counter,  so  subsequent  statements  will  be  assembled  beyond  the  area 
reserved  by  BLOCK  The  aigument  must  be  defined  and  available.  A  warning  will  be  given  if 
the  argument  is  negative  The  loader  will  initialize  each  word  reserved  by  the  BLOCK  statement 
to  zero;  however,  well-written  programs  do  their  own  initialization.  Note  that  the  BLOCK 
pseudo-op  has  no  relation  to  block  structure. 

BLOCK  N  and  ORG  . +N  are  equivalent. 


3.4.2  INTECER  and  ARRAY 


INTEGER  should  be  followed  by  a  list  of  symbols,  separated  by  commas.  Each  of  these  symbols 
is  then  treated  as  a  variable,  i.e.,  as  though  it  had  appeared  in  the  block  where  the  INTEGER 
appears,  followed  by  a  number  sign. 

The  ARRAY  statement  takes  a  list  of  arguments  separated  by  commas.  Each  argument  is  a 
symbol  followed  by  an  expression  in  brackets.  The  effect  is  similar  to  INTEGER,  except  that  the 
expression  (which  ought  to  be  defined  and  available)  denotes  the  number  of  locations  to  be 
reserved  (as  in  BLOCK),  with  the  symbol  being  the  address  of  the  first  one.  For  example, 

ARRAY  F00  (10)  ,BAZ  (20) 

will  reserve  10  words  for  FOO  and  20  words  for  BAZ.  The  symbols  FOO  and  BAZ  are  not 
defined  by  this  statement;  they  can  only  be  used  where  forward  references  are  legal. 
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3.5  Assembler  Control  Statements 


3.5.1  TITLE 


TITLE  names  the  program  and  sets  the  heading  for  the  pages  of  the  listing  There  should  be 
precisely  one  TITLE  statement  per  program,  it  should  appear  before  any  statement  that  generates 
code. 

TITLE  should  be  followed  by  a  string  of  characters,  the  first  part  of  which  should  be  an 
identifier  That  identifier  is  used  as  the  program  name  which  DDT  and  RAID  will  recognize.  It 
is  also  used  as  the  name  of  the  outermost  block. 

The  string  of  characters  in  the  TITLE  statement  is  printed  as  a  part  of  the  heading  on  all  pages 
subsequent  to  the  one  on  which  the  TITLE  statement  appears;  if  TITLE  appears  on  the  first  line 
of  a  page,  it  also  affects  the  heading  on  that  page  The  string  used  in  the  heading  for  TITLE  is 
terminated  by  the  first  carriage  return  or  semicolon. 

If  no  TITLE  statement  appears  before  the  first  symbols  are  emitted  (generally,  at  the  first  BEND 
or  END),  then  FAII  will  generate  a  title  with  pregram  name  ".MAIN”  If  a  TITLE  statement 
appears  after  code  has  been  emitted  (except  for  entry  blocks),  the  resulting  binary  file  may  be 
unsuitable  for  use  as  part  of  a  library  file 


3.5.2  END  and  PRGEND 


The  END  statement  is  the  last  statement  of  a  program.  It  signals  the  assembler  to  stop 
assembling;  no  text  following  it  will  be  processed  If  an  argument  is  given,  it  is  taken  as  the 
starting  address  of  the  program. 


An  END  statement  includes  implicit  VAR  and  LIT  statements  (see  section  3  1.7,  page  25,  and 
section  3.1.6,  page  25).  That  is,  all  outstanding  variables  and  literals  are  placed  starting  at  the 
current  value  of  the  location  counter  when  the  END  is  seen.  Variables  are  put  out  first. 

PRGEND  is  used  in  place  of  END  when  it  is  desired  to  assemble  more  than  one  program  to 
and/or  from  a  single  file  It  behaves  exactly  like  END,  including  taking  an  optional  argument  as 
the  starting  address,  and  then  restarts  FAIL  completely,  except  that  I/O  is  undisturbed,  It 
therefore  cannot  appear  in  a  macro  expansion  or  similar  situation.  PRGEND  is  particularly 
useful  for  directly  assembling  a  library  which  consists  of  many  small  programs. 


3.5.3  COMMENT 


The  first  non-blank  char  cter  following  the  COMMENT  pseudo-op  is  taken  as  the  delimiter  All 
text  from  it  to  the  line  feed  following  the  next  occurrence  of  this  delimiter  is  ignored  by  th^ 
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f  assembler,  except  that  it  is  passed  to  the  listing  file.  The  delimiter  should  not  be  any  one  of  the 

characters  left  arrow  (*-),  colon  (:),  up-arrow  (t),  tilde  (~),  or  number  sign  (#) 


3.5.4  RADIX 


t 

The  RADIX  statement  changes  the  prevailing  radix  until  the  next  RADIX  statement  is 
encountered.  It  has  no  effect  on  numbers  preceded  by  an  equal  sign  The  one  argument  of 
RADIX  is  interpreted  in  the  current  radix  unless  it  is  preceded  by  a  equal  sign  Thus,  the 
statement  RADIX  10  will  have  no  effect  (since  10  in  the  current  radix  equals  the  current  radix) 
The  radix  may  be  set  to  almost  anything,  but  for  radices  above  10  (decimal)  there  are  no  digits  to 
f  represent  10,  II.  etc.  Zero  is  not  permitted,  and  I  should  be  avoided  if  one  is  going  to  use  either 

an  arithmetic  FOR  macro  or  a  macro  argument  with  this  radix 


3.5.5  .INSERT 


I 

The  INSERT  pseudo-op  causes  FAIL  to  remember  its  position  in  the  current  input  file  and  then 
start  reading  (ard  assembling)  another  file  When  the  end  of  the  inserted  file  is  reached,  FAIL 
continues  processing  the  original  file  from  the  point  where  it  left  off.  The  format  is: 

.INSERT  DEV:FILE.EXT(PRJ.PRG3 

The  DEV;  field  is  optional  (the  default  is  DSK:),  it  specifies  the  device  where  the  inserted  file  can 
be  found.  The  (PRJ.PRG1  field  is  optional;  it  has  the  usual  meaning.  In  non-Stanford  FAIL 
installations,  the  file  name  is  scanned  in  accordance  with  the  convention  that  prevails  at  that  site. 

This  pseudo-op  will  not  work  if  it  appears  in  the  input  stream  from  any  device  other  than  DSK, 
since  random  access  features  are  required  to  accomplish  the  repositioning  of  the  file 
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3.6  Listing  Control  Statements 


These  pseudo-ops  affect  the  format  of  the  assembly  listing.  Several  descriptions  below  refer  to 
command  line  switches;  appendix  A,  page  48,  describes  the  command  lint  format  and  the 
different  switches 


3  61  TITLE  and  SUBTTL 


The  TITLE  statement  can  be  used  to  set  the  heading  that  appears  on  the  pages  of  the  listing 
See  section  3.5.1,  page  34  6 

SUBTTL  is  followed  by  a  string  of  characters  which  is  used  as  a  subheading  on  all  subsequent 
pages  until  another  SUBTTL  appears  If  SUBTTL  appears  on  the  first  line  of  a  page,  it  will 
affect  the  subheading  of  that  page  also.  The  string  used  in  the  heading  for  SUBTTL  is 
terminated  by  the  first  carriage  return  or  semicolon. 


3.6.2  LIST,  XLIST,  and  XLIST1 


The  XLIST  statement  causes  listing  to  stop  until  the  next  LIST  statement.  LIST  causes  listing  to 
resume  if  it  has  been  stopped  by  an  XLIST  or  XLISTI  statement.  Otherwise  it  is  ignored.  LIST 
is  the  default. 

The  XLISTI  -tatement  has  exactly  the  same  effect  as  XLIST  unless  the  /I  switch  was  used  in  the 
command  string,  in  which  case  it  is  ignored. 


3.6.3  LALL  and  XALL 


X  ALL  causes  the  listing  of  the  body  of  macros,  REPEATS,  and  FORs  to  be  suppressed  during 
macro  expansion  LALL  causes  it  to  start  up  again  LALL  is  the  default. 


3.64  NOLIT 


This  statement  causes  the  binary  listing  of  code  in  literals  to  be  suppressed.  This  has  the  same 
effect  as  /L  in  the  command  string 
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3.6.5  NOSYM 


This  statement  disables  the  listing  of  the  symbol  table,  counteracting  /S  in  the  command  string 


3.6.6  CREF  and  XCREF 


These  turn  on  and  off  the  emission  of  information  to  CREF,  the  Cross-Reference  Listing  program. 
These  pseudo-ops  have  no  effect  unless  /C  was  used  in  the  command  string.  CREF  is  the  default. 


3.6.7  PACE 


This  pseudo-op  has  the  same  function  as  a  form  feed;  it  is  included  for  compatibility  with 
MACRO- 10.  A  form  feed  is  placed  in  the  listing  immediately  following  PAGE.  The  effect  is  to 
skip  to  the  top  of  the  next  page  of  the  listing.  Use  of  this  pseudo-op  will  destroy  the 
correspondence  between  listing  pages  and  source  file  pages,  so  its  use  is  generally  not 
recommended. 


3.6.8  PRINTX 

This  pseudo-op  causes  the  line  on  which  it  appears  to  be  printed  on  the  user’s  terminal  This  is 
sometimes  useful  for  giving  a  progress  report  during  long  assemblies. 
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,nput  r s,ram  -  •.* 

iterate  the  input  of  a  stream  of  text  a  number  of  times  9i  h  ^  “  Smgle  ,dentlfier  or  to 
specified  which  allow  each  different  occuirence  of  the  text  tn  hi"s  J*"5,  SUbstltut,ons  can  be 

Inc lu'ded thC  ^  °f  3  ^  °f  “«  C0"d“‘°"a'  on' any  of  ^ 


4.1  Macros 


and  „„„„  My:  also.  „  L,  ,  "Z? LP T  A  7cro  h«  *  ->»™ 

characteristics  of  a  macro  are  specified  by  a  DEFINE  statement  °  The  SeVeral 

DEFINE  and  the  macro  name  must  appear  on  the  same  line  ts 

may  be  followed  by  an  op.ional  concatenation  charane  u  The  mC’°  7!ame  is  an  ,dentifiei;  it 
DEFINE.  The  formal  arguments  1? an  are  encled  T*  *  °"  the  Same  as 

The  argument  list  may  occur  on  a  subsequent  line  The  marrnh  ^  seParated  by  commas, 
appears  after  the  argument  list  in  DEFINE.  °dy’  enc*osed  in  braces  ( {  and  ) ), 

In  the  macro  processor,  braces  and  brokets  are  equivalent  ie  "I”  and  "  " 

I  and  >  The  equivalence  between  brokets  and  braces  ’  i  d  are  e9Ulvalent,  as  are 
processor,  the  text  and  examples  that  follow  use  braces  bu  broket!  T”  W‘thm  the  macro 

macro  processoi  counts  braces  independent  of  context  sn’er  r  ?  ’  be  used  Instead  The 

in  comments,  text  constants,  etc.  are  counted  by  the  P  ‘hcally>  braces  and  b'okets  that  appear 
follows,  "non-blank  characwr"  omits  both  blank  and  tab  th'  di!CUS!‘°n  <h« 


4.1.1  Macro  Bodies 


The  macro  My  may  be  any  string  of  characters  suhierr  m, 

braces  must  be  balanced  The  macro  body  itself  J  enclosed  that  t,ie  r,8ht  and  left 

argument  list  in  a  DEFINE  statement  The  macro  bodv  ‘h  bra??la?d  3ppearS  aftci  the 
with  the  macro  name  At  any  point  following  the  DEFINE  dement  i  mem°ry’  associated 
substituted  for  occurrences  of  the  macro  name.  UthlNE  statement-  the  macro  body  will  be 
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4.1.2  Concatenation 


The  concatenation  character  may  be  any  non-blank  character  (excluding  also  carnage  return,  line 
feed,  and  right  brace)  that  appears  in  DEFINE  after  the  macro  name  and  before  the  argument  list 
and  macro  body  This  character  may  then  be  used  to  delimit  identifiers  so  that  they  will  be 
recognized  as  arguments  Appearances  of  this  character  will  be  deleted  from  the  macro  body 
whenever  they  appear.  This  allows  a  macro  argument  to  be  part  of  an  identifier,  instead  of  an 
entire  identifier.  See  the  example  at  the  end  of  section  4.1.6,  page  42. 


4.1.3  Arguments  in  Macro  Definitions 


Arguments  in  macro  definitions  must  be  identifiers  A  list  of  them,  enclosed  in  parentheses,  may 
appear  after  the  macro  name  in  the  definition.  If  no  list  of  arguments  appears  before  the  macro 
body,  it  is  assumed  that  there  are  no  arguments. 

Each  instance  of  an  identifier  in  the  macro  body  which  is  the  same  as  one  of  the  arguments  will 
be  replaced  with  the  string  of  text  corresponding  to  that  argument  when  the  macro  is  called. 
Thus,  if  FUDLY  is  ont  of  the  arguments  in  the  definition  of  a  macro  and  the  following  text 
appears  in  the  body 

A+FUDLY  B 

then  FUDLY  will  be  recognized  as  an  argument  But  if  the  following  appears: 

A+FUDLYB 

then,  since  FUDLYB  is  an  identifier  and  is  different  from  FUDLY,  it  will  not  be  recognized  as  an 
aigument.  To  concatenate  the  "B“  above  with  an  actual  argument,  use  a  concatenation  character. 
For  example,  if  the  concatenation  character  is  "f"  and 

A+FU01Y8B 

appears  in  the  macro  body,  then  FUDLY  will  be  recognized  as  an  argument,  and  the  "I"  will 
disappear  when  the  macro  is  expanded 

H  ?re  is  a  sample  macro  definition 

DEFINE  F00  (AC.ADORS) 
mOVNl  AC.  3 
iriUL  AC.ADORS 
ADD!  AC. 37 
MOVEn  AC.AOORS+1! 

If  the  text 

F00  (A.FARB+7) 


appears  in  the  program  somewhere  after  the  DEFINE  above,  it  will  expand  into 
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MOVNI  A,  3 
IMUL  A.FARB+7 
ADD  I  A. 37 
MOVEtl  A, FARB+7+1 


4.1.4  Macro  Calls 


A  macro  name  may  appear  anywhere  and  will  be  replaced  by  the  macro  body,  as  long  as  the  name 
appears  as  an  identifier  and  is  considered  to  be  an  identifier  by  the  assembler  A  macro  name  may 
appear  alone  on  a  line  or  in  the  accumulator,  index,  or  address  field.  If  the  macro  name  appears 
in  a  context  where  it  is  not  considered  to  be  an  identifier,  the  macro  will  not  be  expanded  For 
example,  macro  names  that  appear  in  a  comment  or  in  the  text  argument  of  an  ASCII  statement 
will  not  be  expanded  Also,  there  are  some  other  cases  where  a  macro  name  will  not  be  expanded 

the  macro  name  in  DEFINE, 

the  formal  argument  list  in  DEFINE  and  FOR, 

the  symbol  name  m  OPDEF,  PURGE,  SUPPRESS  and  RADIX50, 

the  tested  symbol  in  a  symbol  IF, 

the  block  name  in  BEGIN  and  BEND, 

the  location  counter  name  in  USE  and  SET, 

the  universal  symbol  table  name  in  SEARCH,  and 

the  program  name  in  TITLE  and  UNIVERSAL 

Macros  may  be  used  recursively  That  is,  a  macro  body  may  contain  a  macro  call  or  macro 
definition  However,  if  such  macro  calls  are  nested  too  deep,  the  macro  push-down  list  may 
overflow,  resulting  in  an  error  message  and  termination  of  the  assembly  If  this  occurs,  the  /P 
switch  should  be  used  in  the  command  string.  Every  occurrence  of  /P  in  the  command  string 
causes  the  assembler  to  allocate  an  extra  200  (octal)  words  of  memory  for  the  macro  push-down 
list  (see  appendix  A.  page  48) 


4.1.5  Arguments  in  Macro  Calls 


The  list  of  argumen  s  to  a  macro  call  may  be  enclosed  in  parentheses,  or  not.  The  arguments 
themselves  are  sepai  ited  by  commas  For  example,  if  FOO  is  the  name  of  a  macro  that  requires 
two  arguments,  F00  A.FARB+7  and  FOO  (A.FARB+7)  have  the  same  effect. 

If  the  argument  list  is  enclosed  in  parentheses,  then  the  first  argument  begins  with  the  first 
character  aftei  the  "(",  even  if  it  is  blank.  Subsequent  arguments  begin  with  the  first  character 
after  the  comma  that  terminates  the  previous  argument  Arguments  do  not  include  the  comma  or 
used  to  terminate  them  Arguments  are  scanned  until  the  matching  "I"  is  seen 

It  the  argument  list  is  not  enclosed  in  parentheses,  the  first  argument  begins  with  the  first  non¬ 
blank  character  after  the  maao  name  Subsequent  arguments  begin  with  the  first  character  after 
the  comma  that  terminated  the  previous  argument.  Arguments  do  not  include  the  comma  or  other 
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character  used  to  terminate  them  Arguments  are  scanned  until  any  one  of  right  bracket,  right 
broket,  right  brace,  semicolon,  or  carriage  return  is  seen. 

Two  commas  in  a  row  with  nothing  in  between  signify  a  null  argument,  ie.  an  argument  that 
consists  of  no  characters  If  more  arguments  are  called  for  than  are  supplied,  the  last  ones  are 
considered  to  be  null  If  more  arguments  are  supplied  than  are  called  for.  the  extras  are  ignored 
by  the  macro  processor;  see  section  4  16,  page  41 

Unless  the  first  character  of  an  argument  is  the  argument  terminates  at  the  first  comma,  right 
parenthesis,  right  brace  (or  broket),  right  bracket,  or  carriage  return.  If  the  first  character  of  an 
argument  is  I  (or  <  ),  then  all  characters  included  between  the  matching  braces  are  taken  as  the 
argument  This  allows  the  argument  to  contain  commas,  parentheses,  etc  which  would  not  be 
legal  otherwise,  but  the  braces  must  be  kept  balanced.  In  addition,  all  characters  between  the  ”1  " 
that  closes  the  argument  and  the  next  argument  terminator  are  ignored  This  allows  the 
continuation  of  a  list  of  arguments  from  one  line  to  the  next  (i.e.,  enclose  the  last  argument  on  the 
line  in  braces  and  put  the  comma  for  it  at  the  start  of  the  next  line) 

If  the  first  character  of  m  .gument  is  a  backslash  (\)  or  right-arrow  (-*),  then  the  next  thing  after 
the  backslash  (or  right-arrow)  is  considered  to  be  an  expression  (and  it  better  be  defined)  The 
expression  is  evaluated  and  the  value  is  converted  to  a  string  of  ascii  digits  in  the  current  radix 
(the  radix  ought  not  be  I)  This  string  of  digits  is  taken  as  the  argument.  All  characters  from  the 
end  of  the  expression  to  the  next  argument  termination  character  (comma,  etc.)  are  ignored. 

4.1.6  How  Much  is  Eaten  by  a  Macro  Call 


When  a  macro  call  appears,  some  of  the  text  following  the  macro  name  is  considered  to  be  part  of 
the  call.  Any  text  that  is  not  part  of  the  macro  call  will  be  assembled  as  usual.  For  Instance,  if 

DEFINE  F00  (A)  )A  +  7/61 

has  appeared,  then  when 

hOVEI  A.FOO  (3)  (6)  icomment 
appears,  it  will  be  assembled  as 

HOVE  I  A,  3  +  7/6  (6)  ; comment 

Thus,  the  text  F00  (3)  is  considered  to  be  part  of  the  macro  call  and  is  "eaten” 

The  following  rules  govern  how  much  text  gets  eaten  in  a  macro  call  If  the  macro  was  defined  as 
having  no  arguments,  then  only  the  macro  name  and  any  following  spaces  (or  tabs)  are  eaten  If 
the  macro  was  defined  as  having  arguments  and  the  first  non-blank  character  after  the  macro 
name  is  a  left  parenthesis,  then  everything  from  the  macro  name  to  the  right  parenthesis  which 
closes  the  argument  list,  inclusive,  is  eaten  If  the  macro  was  defined  as  having  arguments  and  the 
first  non-blank  character  is  not  a  left  parenthesis,  then  everything  from  the  macro  name  to  the 
comma  or  carriage  return  which  terminates  the  last  macro  argument  used  is  eaten.  Thus,  if 
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fj*  " h*“S  not  used  and  100  few  ar?uments  are  supplied,  everything  from  the  macro  name  to 
the  carriage  return  will  be  eaten.  If  parentheses  are  not  used  and  the  macro  was  defined  as 
having  arguments  and  enough  or  too  many  arguments  are  supplied,  then  everything  from  the 

macro  name  to  the  comma  (or  carnage  return)  which  terminates  the  last  argument  used  will  be 
Cite  n 


Example: 


DEFINE  F00  8  (A, B)  (A8BI 

MOVE  I  F00  1,2,  ,37(61  ;uil!  expand  to: 

i MOVE  I  12  ,37(6) 

;"FQ0  1,2,"  has  been  eaten 


4.1.7  Complex  Example 


Th.s  example  is  given  without  a  full  explanation  It  shows  an  example  of  an  information 

rTyrQgArCIOu  V'l  maCr°  BAR  15  exPanded  <bV  being  redefined)  every  time  that  ADD  I  Is  used 
The  \BAR  in  the  definition  of  ADD  I  is  necessary  to  cause  the  evaluation  of  BAR  as  an  expression 
(which  causes  a  macro  expansion  to  occur).  " 


Example: 


C>l  I 


DEFINE  BAR  (0. } 

DEFINE  F00  (A.B.CI  (DEFINE  BAR  10,  <B 

DEFINE  ADD1  (XI  (F00(\BAR, X)  I 
DEFINE  SEC  ( A , B I  (Bl 


ADD1 (XI) 
ADD1 (X2) 

ADD1 (X3) 


SEC (\BAR) 


:BAR  -  0, 

; BAR  ■  0 , < 

5  Xl> 

; BAR  -  0,< 

:  XI 

;  X2> 

•.BAR  -  0 , < 

XI 

:  X2 

:  X3> 

! THIS  GENERATES  THE  FOLLOWING: 
;  XI 

X2 

i  X3 


♦ 
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4.2  FOR 


There  are  three  types  of  FORs,  all  have  the  same  general  form.  Each  consists  of  the  word  FOR, 
an  optional  concatenation  character,  a  range  specifier,  and  a  FOR-body.  The  FOR  statement 
expands  into  the  text  of  its  FOR-body,  possibly  with  substitutions,  repeated  once  for  each  element 
in  the  range  of  the  FOR.  FOR  replaces  the  IRP  and  IRPC  pseudo-ops  found  in  MACRO- 10. 

The  optional  concatenation  character  is  specified  by  following  the  word  FOR  with  an  at-sign 
followed  immediately  by  the  concatenation  character.  If  a  FOR  is  used  inside  a  macro  and 
concatenation  of  FOR  arguments  is  desired,  it  is  necessary  to  have  a  concatenation  character 
specified  for  the  FOR  which  is  different  from  the  one  for  the  macro. 

The  range  specifier  is  different  for  each  type  of  FOR  and  will  be  explained  below.  The  FOR 
statement  may  have  one  or  two  formal  arguments  which  are  specified  in  the  range  specification. 

The  FOR-body  has  the  same  form  as  a  macro  body;  the  text  is  enclosed  in  braces,  and  braces  must 
be  balanced. 


4.2.1  String  FOR 


The  range  specification  consists  of  one  or  two  formal  argument  identifiers,  followed  by  either  the 
identifier  "IN"  or  the  containment  character  (c),  followed  by  an  argument  list.  The  argument  list 
has  the  same  syntax  as  a  macro  call  argument  list  (see  section  4.1.5,  page  40),  but  the  list  mi  st  be 
in  parentheses.  The  effect  is  that  the  body  of  the  FOR  is  assembled  once  for  each  element  in  the 
argument  list,  and  that  element  is  substituted  for  the  first  (or  only)  formal  argument  each  time 
The  second  formal  argument,  if  present,  will  have  the  remainder  of  the  argument  list  (starting 
with  the  element  following  the  one  currently  substituted  for  the  first  argument)  substituted  for  it. 

Examples: 


Source 


Expansion 


FOR  A  IN  (QRN,  ( ( < JRST  A, >) I ,ST0RP) 
IMOVSI  13, A 
PUSHJ  P.GORP 
I 


NOVSI  13, QRN 
PUSHJ  P.GORP 
NOVSI  13, ( < JRST  4, >) 
PUSHJ  P.GORP 
NOVSI  13.ST0RP 
PUSHJ  P.GORP 


Source 


FOR  ZOT.FUB  c  (A,B,C,D) 
(MOVE I  Z0T.137  ;  FUB  LEFT 
I 


Expansion 

NOVEI  A, 137  ;  B.C.D  LEFT 
NOVEI  B, 137  ;  C.D  LEFT 
NOVEI  C, 137  ;  0  LEFT 
NOVEI  0,137  ;  LEFT 
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4.2.2  Character  FOR 


The  range  specifier  consists  of  one  or  two  formal  arguments  followed  by  either  the  letter  ”E”  or  the 
character  epsilon  (O,  followed  by  a  string  of  characters  enclosed  in  braces.  The  only  restriction  on 
the  string  of  characters  is  that  the  braces  must  balance.  The  body  of  the  FOR  is  assembled  once 
for  each  character  in  the  list,  with  that  character  substituted  for  the  first  formal  argument  each 
time  and  the  rest  of  the  string  substituted  for  the  second  formal  argument,  if  any. 

Examples 

Source  Expansion 

MOVE  I  A, 137  ;  BCD  LEFT 
MOVE  I  B, 137  j  CD  LEFT 
MOVE  I  C, 137  j  D  LEFT 
MOVE  I  D. 137  ;  LEFT 


Source  Expansion 

FOR  <?»  QRN  E  IAZ1Q5I  ZORPA-0 
IZORPJQRN-0  ZORPZ*-0 
•  ZORP1-0 


ZORPQ-0 

ZORP5-0 


4.2.3  Arithmetic  FOR 


This  type  of  FOR  is  similar  to  the  ALGOL  FOR  statement.  The  range  specifier  consists  of  one 
or  two  formal  arguments  followed  by  a  left-arrow,  followed  by  two  or  three  expressions,  separated 
by  commas.  The  expressions  are  like  the  two  or  three  arguments  of  a  FORTRAN  Do’ statement. 
The  value  of  the  first  is  the  starting  value,  the  value  of  the  second  is  the  ending  value,  and  the 

value  of  the  third  is  the  increment  If  the  third  expression  is  not  present,  I  is  used  as  the 

increment 

The  body  of  the  FOR  is  assembled  repeatedly,  first  for  the  starting  value,  then  for  the  starting 
value  plus  the  increment,  etc.  until  it  has  been  assembled  once  for  each  such  value  which  is  less 
than  or  equal  to  the  ending  value  (greater  than  or  equal  if  the  increment  is  negative).  If  the 
starting  value  is  already  greater  than  the  ending  value  (less  than,  for  negative  increment),  the 
FOR  body  is  not  assembled  at  all  For  each  repetition,  the  current  value  is  converted  to  ascii 

digits  in  the  current  radix,  and  that  string  is  substituted  for  the  formal  argument(s)  (both 

arguments  have  the  same  value).  Note  that  all  expressions  must  be  defined,  available,  and 
absolute. 


FOR  ZOT.FUB  <  IABCO* 

'MOVE I  Z0T.137  i  FUB  ( EFT 
I 
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Examples  (assume  RADIX  -8): 


Source 


Expans i on 


FOR  1-1+3,  25,  7 
IXUD  F00, I 
I 


XUO  F00,4 
XUO  F00.13 
XUO  F00.22 


Source 


Expans i on 


FOR  @*  ZOT-ll ,4,-1 
IZOTQSZOT  :  ZOT  +3 
I 


Z0TQ11  :  11  +3 
ZOTQ10  :  10  +3 
Z0TQ7  :  7  +3 
ZOTQG  :  B  +3 
Z0TQ5  :  5  +3 
Z0TQ4  :  4  +3 


4.3  REPEAT 


The  REPEAT  statement  is  included  for  compatibility  with  MACRO-IO.  The  format  is 
REPEAT  exp.  I  text! 

The  expression  exp  is  evaluated,  and  the  text  is  assembled  that  number  of  times,  with  a  carriage 
return  and  line  feed  inserted  at  its  end  each  time.  The  text  is  like  a  macro  body:  braces  must 
balance. 

For  example,  the  statement: 

REPEAT  3.  101 

will  expand  to: 

0 

0 

0 
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4.4  Conditional  Assembly 


The  conditional  assembly  opcodes  (the  IFs)  are  like  macros:  they  will  be  recognized  wherever  they 
appear,  as  long  as  the  assembler  sees  them  as  identifiers.  Thus,  an  IF  need  not  be  the  first  thing 
on  a  line.  Attempts  to  use  IFs  as  symbols  will  produce  erroneous  results. 


4.4.1  Numeric  IFs 


There  are  six  numeric  IFs: 

IFF  exp,  Itextl 
IFN  exp,  Itextl 
IFC  exp,  Itextl 
IFL  exp,  Itextl 
1 FGE  exp,  Itextl 
1FLE  exp,  Itextl 


assembles  text  if  exp=0 
assembles  text  if  exp*0 
assembles  text  if  exp>0 
assembles  text  if  exp<0 
assembles  text  if  exp20 
assembles  text  if  exp<0 


The  expression  exp  is  evaluated.  If  its  value  bears  the  indicated  relation  to  zero,  the  text  is 


assembled  once;  otherwise  it  is  not  assembled, 
macro  body  braces  must  balance. 

Examples: 

IFE  3,  (ZOTI 
I FGE  15,  IJRST  START) 

PUSHJ  P.IFN  FARM.  IBAZ; I F00 
PUSHJ  P.IFN  PARN,  IBAZ: I F00 


The  text,  which  is  called  the  IF-body,  is  like  a 


assembles  nothing 
assembles  wiRST  START 
assembles  PUSHJ  P,BAZ;F00  if  PARHn0 
assembles  PUSHJ  P.FOO  if  PARM-0 


4.4.2  Text  IFs 


There  ate  two  text  IFs.  They  are  IFIDN  and  IFDIF,  which  stand  for  "if  identical”  and  "if 
different",  respectively.  The  format  is 

I F I  ON  Itext  II  (text  2)  (text  3) 

The  texts  can  be  any  string  of  characters  in  which  the  braces  balance.  For  IFIDN,  if  the  two 
strings  text  1  and  text  2  are  identical  in  each  and  every  character,  the  string  text  3  will  be 
assembled,  otherwise  it  will  not.  For  IFDIF,  if  text  1  and  text  2  are  different,  text  3  will  be 
assembled,  otherwise  it  will  not. 
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4.4.3  Symbol  IFs 


There  are  eight  symbol  IFs.  They  are  IFDEF,  IFNDEF,  IFAVL,  IFNAVL,  IFOP,  IFNOP, 
IFMAC,  and  IFNMAC.  A  typical  example  is 

IFDEF  symbol ,  (text! 

If  the  indicated  condition  is  true  for  the  symbol,  the  text  is  assembled;  otherwise  it  is  not.  These 
conditionals  come  in  pairs;  if  one  of  a  pair  is  true,  the  other  is  false. 

IFDEF  is  true  if  the  symbol  is  defined  in  this  block  or  in  an  outer  block  Defined  symbols  may  be 
either  opcodes,  macro  names,  labels,  or  parameters  IFDEF  will  be  tru-:  if  the  symbol  could  be 
used  on  a  line  by  itself  (ignoring  possible  future  definitions). 

IFAVL  is  true  if  the  symbol  is  available.  That  is,  IFAVL  is  true  if  the  symbol  is  defined  as  an 
opcode  or  macro  or  if  it  has  been  defined  in  this  block,  declared  global  in  this  block  and  defined 
in  an  outer  block,  or  defined  in  an  outer  block  with  a  down-arrow. 

IFOP  is  true  ,f  the  symbol  is  defined  as  an  opcode. 

IFMAC  is  true  if  the  symbol  is  defined  as  a  macro  (including  the  IFs,  IOWD,  and  the  predefined 
symbols  .  FNAM  I,  .  FNAM2,  "  and  ") 
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Command  Language 


The  basic  format  of  a  FAIL  command  is 

b  i  nary-f  i  le,  I  istiny-fi  le«-source-f  i  te-1 . source- f  i  le-n 

File  specifications  consist  of 
dev i ce: f i I e 

If  device:  is  missing,  OSK:  is  assumed  Either  (or  both)  output  file(s)  may  be  omitted.  If  the 
listing-tile  is  included,  a  comma  must  precede  it.  Source-file  names  are  separated  by 
commas.  The  device  name  for  source  files  is  sticky,  so  to  change  devices  the  device  name  must  be 
explicit,  even  if  it  is  DSK:  Multiple  source  files  are  concatenated  as  one  assembly.  If  the  last 
source-f  i  le  name  on  a  line  ends  with  a  comma  (and  carnage  return-line  feed)  then  the  next  line 
is  taken  as  a  continuation  of  this  command 

If  no  file  extension  is  given  for  the  binary  and  list  files,  REL  and  LST  are  assumed,  respectively  (in 
the  non-Stanford  FAIL,  CRF  is  the  default  extension  for  the  list  file).  If  no  extension  is  given  for 
the  source  file(s),  FA1  is  tried  first;  failing  that,  a  blank  extension  is  tried. 

Switches  should  foilow  file  names  and  may  be  either  of  the  slash  type  or  parentheses  type  (e.g., 
"/ x"  or  "  (x) "). 

Device  switches  (must  follow  the  name  of  the  affected  file): 

nA  advance  magnetic  tape  n  files 

nB  backspace  magnetic  tape  n  files 

T  skip  to  logical  end  of  magnetic  tape 

U  rewind  magnetic  tape 

Z  zero  OECtape  directory 

Assembler  switches  (may  appear  after  any  file  name): 

C  make  a  cross-reference  (CREF)  listing 

F  don't  pause  after  errors  (inverse  of  R) 

I  ignore  XLITl  pseudo-op 

J  turn  on  cross-ref erence  listing  output 

K  turn  off  cross-reference  listing  output 

L  don’t  list  literal  values  with  text 

N  don't  list  assembly  errors  on  TTY 

R  pause  after  each  assembly  error 

S  list  symbol  table 

U  underline  macrp  expansions  on  listing 

nV  set  the  number  of  lines/page  in  listing  to  n 

X  don’t  list  macro  expansions 

The  P  swi'ch  is  used  to  allocate  extra  space  L  the  macro  push-down  list  (PDL),  which  is 
normally  200  (octal)  locations  long.  If  recursive  macros  are  used,  more  space  may  be  needed  The 
macro  PDL  will  be  expanded  by  200  words  for  every  occurrence  of  the  P  switch  in  the  command 
string  A  numeric  argument  may  given  with  the  P  switch  to  specify  a  multiple  of  200  words  by 
which  to  expand  the  PDL 
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Sometimes,  assembly  parameters  are  specified  from  the  user  terminal,  rather  than  being  included 
in  the  source  program.  Suppose  the  line  SEGSU«-«-l  needs  to  be  included  in  the  assembly  of  the  file 
BAZ  The  followirg  command  sequence  would  do  that  (and  make  a  cross-reference  listing  of 
BAZ) 

BAZ.tJH^./L.WTY:  ,DSK:BAZ 

SEGSU*-*-l 

tz 

The  text  is  typed  to  FAIL  and  terminated  with  control-Z  (tZ)  (at  Stanford  displays,  control-meta 
line  feed  is  used  instead  of  control-Z).  Using  RPC  (known  elsewhere  as  COMPIL),  the  command 
sequence  would  be 

COMPI LE/CREF  TTY:F+DSK:BAZ 

SEGSU—1 

tZ 

The  file  name  F  is  needed  to  satisfy  the  RPC  syntax;  the  device  name  DSK:  is  needed  to  switch 
the  default  input  device  to  DSK 

If  the  command  FILE®  is  seen,  the  named  file  will  be  read  and  interpreted  as  containing  a  series 
of  commands  of  the  usual  form. 

The  command  FILE1  causes  FAIL  to  exit  and  run  the  named  program.  The  default  device  for 
this  command  is  SYS:. 

To  provide  some  compatability  with  RPG-style  commands,  FAIL  accepts  for  V  in  the 
command  line.  Also,  either  "+"  or  may  be  used  instead  of to  separate  source- f  i  le  names. 
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Relocatable  and  Undefined  Values 


FAIL  binary  programs  are  usually  required  to  be  relocatable,  i.e.,  loadable  anywhere  in  a  core 
image  Many  values  depend  upon  the  absolute  location  of  a  program  within  its  core  image,  eg  , 
the  target  address  of  a  branch  instruction.  The  final  determination  of  these  values  must  be  made 
by  the  loader. 

The  problem  of  relocation  can  usually  be  reduced  to  a  question  of  whether  or  not  to  augment  a 
value  by  the  relocation  constant,  which  is  simply  the  location  at  which  the  loader  decides  to  beein 
loading  this  program  The  mechanism  for  handling  this  involves  associating  with  each  value  a 
relocation  factor,  which  is  (at  load  time)  to  be  multiplied  by  the  relocation  constant  and  added  to 
the  value.  For  the  simple  relocation  mechanism  to  work,  the  relocation  factor  must  be  a  constant 
and  either  0  or  I.  Since  36  bits  may  contain  two  18-bit  addresses,  a  relocation  factor  is  provided 
for  each  halfword.  Thus,  a  value  which  is  completely  determined  except  for  simple  relocation  can 
be  expressed  in  38  bits.  A  value  in  which  at  least  one  relocation  factor  is  non-zero  is  said  to  be 
relocatable,  one  in  which  both  are  zero  is  said  to  be  unrelocatable  or  absolute. 

There  is  a  more  general,  less  efficient  mechanism  for  delaying  calculations  u»  til  load  time.  This  is 
used  in  more  complex  cases  where  the  simple  relocation  scheme  is  inadequate.  Whenever  a  value 
cannot  be  calculated  immediately  and  cannot  be  handled  by  the  relocation  mechanism  because  it 
requires  some  other  type  of  deferred  calculation,  the  value  is  said  to  be  undefined .  Undefined 
values  are  represented  by  relatively  complex  structures  which  are  retained  in  KAIL  for  final 
evaluation  or,  if  necessary,  passed  to  the  loader  for  evaluation  Undefined  values  are  illegal  in 
those  contexts  which  require  the  value  to  be  immediately  known,  including  some  situations  where 
the  relocation  factor  mechanism  is  legal.  The  legality  of  undefined  or  relocatable  values  is 
indicated  in  the  discussion  of  each  possible  usage. 
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Predefined  Opcodes 


The  standard  machine  instruction  mnemonics  of  the  PDP-IO  (KA-IO)  are  defined  in  FAIL. 

When  the  Stanford  version  of  FAIL  is  started,  it  obtains  from  the  system  the  definitions  for  all 
system  UUOs  and  CALLIs  that  are  available  at  the  time  of  the  assembly 

The  table  that  follows  includes  all  the  pseudo-ops,  machine  instruction  mnemonics,  special 
symbols,  and  UUO  mnemonics  currently  available  at  Stanford  The  indication  SAIL  is  used  to 
indicate  UUOs  and  machine  instructions  available  only  at  Stanford  The  indication  UUO  is  used 
to  mark  system  calls  that  are  also  available  on  a  DEC  system.  Hardware  I/O  instructions  are 
indicated  by  I/O;  these  instructions  are  not  available  to  normal  user  programs.  Machine 
instruction  mnemonics  for  the  KI-IO  processor  are  available  as  a  conditional  assembly  feature  in 
FAIL,  these  are  flagged  with  the  indicat.on  KI.  The  entry  for  each  pseudo-op  includes  the  page 
number  where  that  pseudo-op  is  explained. 

Note  that  there  are  sometimes  subtle  differences  between  DEC  system  UUOs  and  Stanford  UUOs; 
consult  the  appropriate  reference  manual.  Also  note  that  some  DEC  mnemonics  conflict  with 
those  used  at  Stanford. 
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s. 

Predef ined 

page  14 

BLT 

251800, ,0 

DIVB 

237888, ,0 

• 

Prede  1  mad 

page  14 

BUFLEN 

CALLI  400042 

SAIL 

OIVI 

235000, ,0 

.FNAH1 

Pradef inad 

page  15 

BYTE 

Pseudo-Dp 

page  38 

D1VN 

236800, ,8 

.  FNAN2 

Pradef inad 

page  15 

ONOVE 

120000,, 0 

X I 

.  INSERT 

Paaudo-Op 

page  35 

CA! 

300008, ,0 

DNOVEH 

124000, ,0 

KI 

•LIBRARY 

Pseudo-Dp 

page  28 

CAIA 

304000,  ,0 

DNDVN 

121000, ,8 

X  1 

•  LOAD 

Pseudo-Op 

page  28 

CAIE 

302080, ,0 

ONDVNH 

125800, ,0 

KI 

CAIG 

307800, ,0 

OPB 

137000, ,0 

ACCTItl 

COLLI  400181 

SAIL 

CBIGE 

305000,, 0 

DPYCLR 

701880, , 0 

SAIL 

ACTCHR 

CALL  I  48010S 

SAIL 

CAIL 

301000, ,0 

DPYDUT 

783000, ,0 

SAIL 

ADD 

270000, ,0 

CAILE 

303000, ,0 

OPYPOS 

702100, ,8 

SAIL 

ADDB 

273000,, 0 

CAIN 

306000,, 0 

DPYSIZ 

702140, ,0 

SAIL 

ADD! 

271080, ,0 

CALL 

040000,  ,0 

UUO 

DSKPPN 

CALLI  400071 

SAIL 

ADDN 

272000, ,0 

CALLI 

047000, ,0 

UUO 

DSKTIN 

CALLI  408072 

SAIL 

AOSnAP 

COLLI  400110 

SAIL 

CALLIT 

CALLI  405374 

SAIL 

AND 

404000,, 0 

CAM 

310000, ,8 

EIOTN 

CALLI  400005 

SAIL 

ANDB 

407000, ,0 

CANO 

314000, ,0 

END 

Pseudo-Dp 

page  34 

ANOCA 

410000, ,8 

CAME 

312000,, 8 

ENTER 

077000,  ,0 

UUO 

ANDCAB 

413000, ,8 

CAMG 

317000, ,0 

ENTRY 

Pseudo-Dp 

page  27 

ANOCA I 

411000, ,0 

CONGE 

315000, ,0 

EQV 

444000, ,0 

ANOCAH 

412000, ,0 

CANL 

311000, ,0 

EQVB 

447000, ,0 

ANDCB 

440800, ,0 

CANLE 

313000, ,8 

EQV  I 

445000, , 0 

ANDCBB 

443000, ,0 

CONN 

316000,, 0 

EQVN 

446000, ,0 

ANDCBI 

441000, ,0 

CHNSTS 

716000, ,0 

SAIL 

EXCH 

250080, ,0 

anocbn 

442000,, 0 

CL.'INT 

717000, ,0 

SAIL 

EXIT 

CALLI  12 

UUO 

ANDCM 

420000, ,0 

CLOSE 

870080, ,0 

UUO 

EXTERNAL 

Pseudo-Op 

page  27 

ANDCNB 

423000, ,0 

CLRBFI 

051440, ,0 

UUO 

ANDCfll 

421000, ,0 

CLRBFO 

051500, ,0 

UUO 

FAD 

140000, ,0 

andcnh 

422000,, 0 

COHNENT 

Psaudo-Op 

page  34 

FADB 

143000, ,0 

ANOI 

405000,, 0 

CONI 

700240,, 0 

I/O 

FOOL 

141000, ,0 

ANOH 

406000,  ,0 

CONO 

780280, ,0 

I/O 

FSDil 

142080, ,8 

AOBJN 

253000,  ,0 

CONS 

257088,, 0 

SOIL 

FROR 

144000, ,6 

ADBJP 

252000,,  0 

CONSO 

700340,, 0 

I/O 

FAORB 

147000, ,0 

AO  J 

340000, ,0 

CONSZ 

700308,, 8 

I/O 

FRDRI 

145000,  ,0 

ADJA 

344000, ,0 

CORE 

CALLI  11 

UUO 

FAORL 

145000, ,0 

AO  JE 

342000,, 0 

C0RE2 

CALLI  400015 

SAIL 

FADRH 

146000,  ,0 

AO  JG 

347000,, 0 

CREF 

Pseudo-Op 

page  37 

FB3EAD 

706000, ,0 

SA  TL 

AOJCE 

345000,, 0 

CTLV 

CALLI  480801 

SAIL 

FBUOIT 

CALLI  400057 

SAIL 

AOJL 

341000, ,0 

FBURT 

707000,, 0 

SAIL 

AOJLE 

343000,  ,0 

OATH  I 

700040,, 0 

I/O 

FDV 

170000,, 0 

AO  JN 

346000,  ,0 

OATAO 

700140, ,8 

I/O 

FOVB 

173080, ,0 

AOS 

350000, ,0 

DATE 

CALLI  14 

UUO 

FOVL 

171080,  ,0 

AOSA 

354000, ,0 

OAYCNT 

CALLI  400100 

SOIL 

FDVN 

172000,  ,0 

A03E 

352000, ,0 

OOCBAN 

CALLI  400067 

SOIL 

FDVR 

174000, ,8 

AOSC 

357000, ,0 

OOTGT 

CALLI  5 

UUO 

FOVRB 

177000,  ,0 

AOSGE 

355000, ,0 

OOTIN 

CALLI  1 

UUO 

FDVRI 

175000, ,0 

AOSL 

351000, ,0 

OOTOUT 

CALLI  3 

UUO 

FDVRL 

175008, ,0 

AOSLE 

353000, ,0 

OOTRL 

COLLI  7 

UUO 

FOVRH 

176000, ,0 

AOSN 

356000, ,8 

ODUPG 

715140, ,0 

SAIL 

FIX 

247000. ,0 

SAIL 

APRENB 

CALL  I  16 

UUO 

OEBREAK 

CALLI  400035 

SAIL 

FIX 

122800, ,0 

x: 

ARRAY 

Pseudo-Op 

page  33 

OEC 

Pseudo-Op 

page  30 

FIXR 

1268v30,,0 

XI 

ASCID 

Pseudo-Op 

page  32 

DEFINE 

Pseudo-Dp 

page  38 

FLTR 

127000, ,0 

XI 

ASCII 

Pseudo-Op 

page  32 

Ot'PHASE 

Pseudo-Dp 

page  23 

FNP 

168008, ,0 

ASCI2 

Pseudo-Op 

page  32 

OETSEG 

CALLI  400817 

SOIL 

FHPB 

163000, ,8 

ASH 

240800, ,8 

OEVCHR 

CALLI  4 

UUO 

FNPL 

101000, ,0 

ASHC 

244003, ,0 

OEVNUH 

CALLI  400104 

SOIL 

FHPH 

162000, ,8 

ASUPPRtSS  Pseudo-Op 

page  29 

OEVUSE 

CALLI  400051 

SOIL 

FHPR 

164000, ,8 

ATTSEG 

CALLI  400016 

SAIL 

DFAO 

118000, ,0 

XI 

FNPRB 

167000, ,0 

OFOV 

11 3000,, 8 

X 1 

FNPRI 

165000, ,0 

BEEP 

CALLI  408111 

SOIL 

01  np 

112000, ,0 

XI 

FNPRL 

165000, ,0 

BEGIN 

Pseudo-Op 

page  26 

DFN 

131000, ,0 

FNPRH 

166800, ,0 

BENO 

Pseudo-Op 

page  26 

OFSB 

111000, ,0 

XI 

FDR 

Pseudo-Dp 

page  43 

BLX I 

700008, ,8 

I/O 

DIAL 

CALLI  400117 

SAIL 

FSB 

150080, ,8 

BLKO 

700188, ,0 

I/O 

DISNISS 

CALLI  400024 

SAIL 

FSBB 

153080, ,0 

BLOCK 

Pseudo-Dp 

page  33 

OIV 

234000,, 0 

FSBL 

151000, ,0 
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FSBft  152000, ,0 

FSBR  154000, ,0 

FSBRB  157000,, 0 

FSBR I  155000,, 8 

FSBRL  155000,, 0 

FSBRB  15GOOO, ,0 

FSC  132000, ,0 

GOP  Tin  COLLI  400065  SOIL 

GETCMR  COLLI  6  UUO 

GETL1N  051300, ,0  501L 

GETIN  COLLI  34  UUO 

GETNOtl  COLLI  400062  SOIL 

CETPPN  COLLI  24  UUO 

GETPR2  COLLI  400053  SOI- 

GETPRV  COLLI  400115  SOIL 

GETSEG  COLLI  40  UUO 

CET3TS  062000,, 0  UUO 

GETTBB  COLLI  41  UUO 

GLORRL  Pseudo-Op  page  26 


HOLT 

254200,  ,0 

HISEG 

Pseudo-Op 

HLL 

500000, ,0 

HLLE 

530000, .0 

HLLEI 

531000, ,0 

HLLEB 

532000, ,0 

HLLES 

533000, ,0 

HLL  1 

501000, ,0 

MLLM 

502000, ,0 

HLLO 

520000, ,0 

HLLOI 

521000, ,0 

HLLOtl 

522000, ,0 

HLL05 

523000, ,0 

HLL  5 

503000. ,0 

hll: 

510000, ,0 

HLLZI 

511000, ,0 

HLLZtl 

512000, ,0 

HLLZS 

513000, ,0 

MLR 

544000, ,0 

HLRE 

574000, ,0 

HLRE  I 

5751)00, ,  0 

HLREM 

576000, ,0 

HLRES 

577000, ,0 

MLR  I 

545000, ,0 

HLRtl 

546000, ,0 

HLRO 

664000, ,0 

HLROI 

565000, ,0 

HLROn 

566000,  ,0 

HLROS 

567000,  ,0 

HLRS 

547000,  ,0 

HLRZ 

554000,  ,0 

hlr:i 

555000, ,0 

HLRZtl 

556000, ,0 

HLR2S 

557000,  ,0 

HRL 

504000,  ,0 

HRLE 

534000,, 0 

HRLEI 

535000, ,0 

HRLEB 

536000, ,0 

HRLES 

537000, ,0 

HRL  I 

505000, ,0 

HR  LB 

506000 , ,0 

HRLO 

524000, ,0 

HRLOI 

525000,  ,0 

HRLOB 

526000,  ,0 
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HRLOS 

527000, ,0 

HRL  5 

507000, ,0 

HRL2 

514000, ,0 

HRL21 

515000, ,0 

HRL2f1 

516000, ,0 

HRLZS 

517000, ,0 

HRR 

540000, ,0 

HRRE 

570000, ,0 

HRRE1 

571000, ,0 

HRREfl 

572000, ,0 

HRRES 

573000,, 0 

HRR  1 

541000,  ,0 

HRRtl 

542000,  ,0 

HRRO 

560000,  ,0 

HRRO! 

561000, ,0 

HRROfl 

562000, ,0 

HRROS 

563000, ,0 

HRRS 

543000,  ,0 

HRR2 

550000,  ,0 

HRR2I 

551000, ,0 

hrr  zn 

552000,, 0 

HRR25 

553080, ,0 

IBP 

133000, ,0 

10 IV 

230000, ,0 

101 VB 

233000, ,0 

101V1 

231000, ,0 

loivn 

232000,, 0 

10PR 

136000,. 0 

IENBU 

CBLLI  400045 

SRI  L 

IFBVL 

Condi t iona 1 

page  47 

IFOEF 

Cond i 1 1  on a  I 

page  47 

IFOIF 

Condi  1 iona 1 

page  46 

IFE 

Condi  1 ional 

page  46 

IFG 

Condi t iona 1 

page  46 

IFGE 

Cond 1 1 1 ona ! 

page  46 

IF  ION 

Condi t Ional 

page  46 

IFl 

Condi t ional 

page  46 

IFLE 

Conditional 

page  46 

IFflflC 

Condi t iona 1 

page  47 

IFN 

Condi t Ional 

page  46 

IFNBVL 

Condi t Iona  1 

page  47 

IFNOEF 

Cond i t iona 1 

page  47 

IFNMBC 

Cond i t iona  i 

page  47 

IFNOP 

Cond i 1 iona 1 

page  47 

IFOP 

Condi t  iona 1 

page  47 

I  LOB 

134000, ,0 

IH5FCL 

722000,, 0 

5RIL 

insrcR 

723240, ,0 

SOIL 

insFST 

721000, ,0 

SR  I L 

insTU 

723040,, 0 

SRIL 

inuL 

220000,, 0 

muLB 

223000,, 0 

muLi 

221000, ,0 

inuLn 

222000, ,0 

IN 

056000, ,0 

UUO 

INBUF 

864000, ,0 

UUO 

INCHR5 

051 100, ,0 

UUO 

1NCHRU 

051000, ,0 

UUO 

INCH5L 

051240, ,0 

UUO 

1NCHUL 

051200,, 0 

UUO 

IN  I T 

041000, ,0 

UUO 

INPUT 

066000,,  0 

UUO 

INSUP 

051540,  ,0 

SRIL 

INTBCfl 

CALL!  400027 

SRIL 
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1NT0EJ 

723000,  ,0 

SRIL 

1NT0BP 

723140,  ,0 

SRIL 

INTEGER 

Pseudo-Op 

page  33 

INTENB 

CRLLI  400025 

SRIL 

INTENS 

CRLLI  400030 

SRIL 

INTERNAL 

Pseudo-Op 

pagn  27 

INTGEN 

CRLLI  400033 

SRIL 

INTI  IP 

CRLLI  400031 

SRIL 

INTIPI 

723200, ,0 

SRIL 

I  NT  IRQ 

CRLLI  400032 

SRIL 

INT JEN 

723000, ,0 

SRIL 

1NTHSK 

720000, ,0 

SRIL 

INTORn 

CRLLI  400026 

SRIL 

'NTUUO 

723000, ,0 

SRIL 

INUR I " 

051600, ,0 

SRIL 

I0P0L 

726000, ,0 

SRIL 

IOPOP 

725000, ,0 

SRIL 

IOPUSH 

724000, ,0 

SRIL 

IOR 

434000,  ,0 

I0RB 

437000,  ,0 

IORI 

435000,  ,0 

I0RH 

436000,  ,0 

I0U0 

Pseudo-Op 

1  itiqti  31 

IURIT 

CRLLI  400040 

SOIL 

iukbsk 

723100, ,0 

SRIL 

JBTSTS 

CRLLI  400013 

SRIL 

JCRY 

255300, ,0 

JCRYO 

255200, ,0 

JCRY1 

255100. ,0 

JEN 

254500, ,0 

JFCL 

255000, ,0 

JF.F0 

243000, ,0 

JFOV 

255040, ,0 

JOBRO 

CRLLI  400050 

SRIL 

JOV 

255400, ,0 

JRR 

267000, ,0 

JRST 

254000,  ,0 

JRSTF 

254100,, 0 

JSR 

266000, ,0 

JSP 

265000, ,0 

J5R 

264000, ,0 

junp 

320000, ,0 

JunPR 

324000,  ,0 

JUtIPE 

322000,  ,0 

JUtIPG 

327000,  ,0 

JUflPGE 

325000, ,0 

jubpl 

321000,  ,0 

JUtIPLE 

323000,  ,0 

junPN 

326000, ,0 

LRLL 

Pseudo-Op 

page  36 

LOB 

135000, ,0 

LEYPOS 

702300, ,0 

SOIL 

LINK 

Psoudci-Op 

page  27 

LINKENC 

1  Pseudo-Op 

paqe  27 

LINKUP 

CRLLI  400023 

SRIL 

LIOTfl 

CRLLI  400006 

SRIL 

LIST 

Pseudo-Op 

page  36 

LIT 

Pseudo-Op 

pago  25 

LOC 

Pseudo-Op 

page  22 

LOCK 

CRLLI  400076 

5RIL 

LOGIN 

CRLLI  15 

UUO 

LOGOUT 

CRLLI  17 

UUO 

LOOKUP 

076000,  ,0 

UUO 

iV'  .  -  > ' 
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LSH 

242000, ,0 

PGIOT 

7 1S000, , 0 

SAIL 

SETAB 

427000, ,0 

LSHC 

246000, ,0 

PGSEL 

71S00O, , 0 

SAIL 

SETACT 

0S1640, ,0 

SAIL 

PHASE 

Pseudo-Op 

page  23 

SETA  I 

42S00O , , 0 

MAIL 

710000, ,0 

SAIL 

PJOB 

CALLI  30 

UUO 

SETAM 

426000,, 0 

MAP 

2S7000, ,0 

K1 

PNAME 

CALLI  400007 

SAIL 

SETCA 

4SO0O0, , 0 

MOVE 

200000, ,0 

POINT 

Pseudo-Op 

page  31 

SETCAB 

4S300O, , 0 

MOVE  I 

201000, ,0 

POINTS 

712000, ,0 

SAIL 

SETCA I 

4S10O0, ,0 

MOVEM 

202000, ,0 

POP 

262000, ,0 

SETCAM 

452000,, 0 

MOVES 

203000, ,0 

P0PJ 

263000,, 0 

SETCM 

460OO0, ,0 

MOVM 

214000, ,0 

PORTAL 

2S4040, ,0 

KI 

SETCMB 

463000, ,0 

MOVMI 

21SO00, , 0 

PPACT 

702040, ,0 

SAIL 

SETCMI 

461000, ,0 

MOVMM 

216000, ,0 

PPHLO 

702340, ,0 

SAIL 

SETCMM 

462000, ,0 

MOVMS 

217000,  ,0 

PPINFO 

702240, ,0 

SAIL 

SETCRO 

CALL!  400073 

SAIL 

MOVN 

210000, ,0 

PPIOT 

702000, ,0 

SAIL 

SET0OT 

CALLI  2 

UUO 

MOVNI 

211000, ,0 

PPREL 

702200,, 0 

SAIL 

SETLIN 

0S1340, ,0 

SAIL 

MOVNM 

212000, ,0 

PPSEL 

702oeo , , 0 

SAIL 

SETM 

414000, ,0 

MOVNS 

213000, ,0 

PPSPY 

CALLI  400107 

SAIL 

SETMB 

417000, ,0 

MOVS 

20 ,000, ,0 

PRGENO 

Psaudo-0p 

page  34 

SETMI 

4 1SO00 , , 0 

MOVSI 

20SO00, ,0 

PR1NTX 

Pseudo-Op 

page  37 

SETMM 

416000, ,0 

M0V3M 

206000, ,0 

PTGETL 

711S40, ,0 

SAIL 

SETNPM 

CALLI  43 

UUO 

MOVSS 

207000, ,0 

PTIFRE 

711100, ,0 

SAIL 

SETNM2 

CALLI  400036 

SAIL 

MSTIME 

CALLI  23 

UU0 

PTJOBX 

711700, ,0 

SAIL 

SETO 

474000, ,0 

MTAPE 

072000, ,0 

uuo 

PTL0A0 

711640, ,0 

SAIL 

SET0B 

477000, ,0 

MUL 

224000, ,0 

PTOCNT 

711140, ,0 

SAIL 

SETOI 

47S0O0, ,0 

MULB 

227000,, 0 

PTR01S 

711200, ,0 

SAIL 

SETOM 

476000, ,0 

MUL  I 

22SO0O, ,  0 

PTR01U 

711240, ,0 

SAIL 

setpov 

CALLI  32 

UUO 

MULM 

226000, ,0 

PTROS 

711400, ,0 

SAIL 

SETPR2 

CALLI  40O0S2 

SAIL 

PTSETL 

711600, ,0 

SAIL 

SETPRO 

CALLI  400020 

SAIL 

NAMEIN 

CALLI  400043 

SAIL 

PTWR1S 

711300, ,0 

SAIL 

SETPRV 

CALLI  400066 

SAIL 

NOLIT 

Pseudo-Op 

pegs  36 

PTWR1W 

711340, ,0 

SAIL 

SETSTS 

060000,, 0 

UUO 

NOSYM 

Pseudo-Op 

page  37 

PTURS7 

711440, ,0 

SAIL 

SETUUP 

CALLI  36 

UUO 

PTURS9 

711S00, ,0 

SAIL 

SET2 

400000, ,0 

OCT 

Pseudo-Op 

page  30 

PTYGET 

711000, ,0 

SAIL 

SETZB 

403000, ,0 

OPOEF 

Pseuda-0p 

page  26 

PTYREL 

711040, ,0 

SAIL 

SET2I 

401000, ,0 

OPEN 

0S0000, ,0 

UUO 

PTYUUO 

711000, ,0 

SAIL 

SET2M 

402000, ,0 

OR 

434000,, 0 

PURGE 

Pseudo-0p 

page  28 

SIXBIT 

P»eudo-0p 

page 

ORB 

437000, ,0 

PUSH 

261000, ,0 

SKIP 

330000, ,0 

ORCA 

454000,  ,0 

PUSHJ 

260000, ,0 

SKIPA 

334000, ,0 

ORCAB 

4S7O0O ,  ,0 

PEE 

000000,, 0 

SKIPE 

332000, ,0 

ORCAI 

4S5OO0, ,0 

SKIPG 

337000, ,0 

ORCAM 

4S6000, ,0 

RAO  IX 

Pseudo-0p 

page  3S 

SKIPGE 

33SO00, ,0 

ORCR 

470000, ,0 

RAOIXS0 

Pseudo-Op 

page  32 

SKIPL 

331600, ,0 

ORCBB 

473000, ,0 

REASSI 

CALLI  21 

UUO 

SKIFLE 

3330OO, ,0 

ORCBI 

471000,  ,0 

RELEAS 

071000, ,0 

UUO 

SKIPN 

336000,, 0 

ORCBM 

472000,  ,0 

RELOC 

Pseudo-Op 

page  22 

SKPHIM 

710200, ,0 

SAIL 

ORCM 

464000, ,0 

REMAP 

CALLI  37 

UUO 

SKPME 

710140, ,0 

SAIL 

ORCMB 

467000, ,0 

RENAME 

0SS00O, ,0 

UUO 

SKPSEN 

710240, ,0 

SAIL 

ORCM  I 

46S000, ,0 

REPEAT 

Pseudo-Op 

page  4S 

SLEEP 

CALLI  31 

UUO 

ORCMM 

466000, ,0 

RESCAN 

051400, ,0 

UUO 

SLEVEL 

CALLI  400044 

SAIL 

ORG 

Pseudo-Op 

page  22 

RESET 

CALLI  0 

UUO 

SNEAKS 

CALLI  400064 

SAIL 

OR  I 

43S0O0, ,0 

RLEVEL 

CALLI  4000S4 

SAIL 

SNEAKU 

CALLI  400063 

SAIL 

ORM 

436000, ,0 

R0T 

241000,, 0 

S0J 

360000, ,0 

OUT 

057000,  ,0 

UUO 

R0TC 

24S  000 , , 0 

50  JA 

364000,, 0 

OUTBUF 

06S0OO, ,0 

UUO 

RUN 

CALLI  3S 

UUO 

SOJE 

362000, ,0 

OUTCHR 

OS  104  0 , ,0 

UUO 

RUNMSK 

CALLI  400046 

SAIL 

SOJG 

367000, ,0 

OUTPIV 

051740, ,0 

SAIL 

RUNTIM 

CALLI  27 

UUO 

S0JGE 

36S000, ,0 

OUTPUT 

067000, ,0 

UUO 

S0JL 

361000, ,0 

OUTS  TR 

0S1140, ,0 

UUO 

SEARCH 

Pseudo-0p 

page  29 

S0JLE 

363000, ,0 

SEGNAM 

CALLI  400037 

SAIL 

S0JN 

366000, ,0 

PAGE 

Pseudo-Op 

page  37 

SEGNUM 

CALLI  400021 

SAIL 

SOS 

370000, ,0 

PEEK 

CALLI  33 

UUO 

SEGSI2 

CALLI  400022 

SAIL 

SOSA 

374000,  ,0 

PGACT 

71S040, ,0 

SAIL 

SENO 

710000, ,0 

SAIL 

SOSE 

372000,  ,0 

PGCLR 

715100, ,0 

SAIL 

SET 

Pseudo-Op 

page  22 

SOSG 

377000, ,0 

PGINFO 

71S200, ,0 

SAIL 

SETA 

424000, ,0 

SOSGE 

37S000, ,0 

FAIL 
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SOSL 

37  lpno, ,0 

TR2 

620000, ,0 

XLIST1 

Pseudo-Op 

SOSLE 

373000, ,0 

TR2A 

624000,  ,0 

XOR 

430000, ,0 

SOSN 

376000, ,0 

TR2E 

622000, ,0 

XORB 

433000, ,0 

SPCIIAR 

043000, ,0 

SAIL 

TRZN 

626000, ,0 

XOR  I 

431080, ,0 

SPCUGO 

CALL  I  400003 

SAIL 

TSC 

651000, ,0 

XORH 

432080, ,0 

SPUBUT 

CALL  I  400000 

SAIL 

TSCA 

6SS000, ,0 

XPUNGE 

Pseudo-Op 

SRCV 

710100, ,0 

SAIL 

TSCE 

6S3000, ,  0 

XUD 

Pseudo-Op 

STATO 

061000, ,0 

UUO 

TSCN 

6S7000, ,0 

ST0T2 

063000, ,0 

UUO 

TSN 

611000, ,0 

SUB 

274000, ,0 

T5NA 

61S000, ,0 

SUBB 

277000, ,0 

TSNE 

6 13000,, 0 

SUB  1 

27S000,  ,0 

TSNN 

617000, ,0 

subo 

276000,  ,0 

TSO 

671000, ,0 

SUBTTL 

Ps9udo-0p 

page  36 

TSOA 

67S000, ,0 

SUPPRESS 

Pseudo-Op 

page  29 

TSOE 

673000, ,0 

SUOP 

CALL  1  400004 

SAIL 

7S0N 

677000, ,0 

SU1TCH 

CALL  1  20 

UUO 

TS2 

631000, ,0 

TSZA 

63S000, ,0 

TOC 

650000, ,0 

TS2E 

633000,, 0 

TDCfl 

654000, ,0 

TS2N 

637000, ,0 

TOCE 

652000, ,0 

TTCALL 

OS  1000, , 0 

UUO 

TOCN 

6S6000, ,0 

TTREAO 

051700, ,0 

SAIL 

TON 

610000, ,0 

TTYIOS 

COLLI  400014 

SAIL 

TONA 

614000, ,0 

TTYJOB 

CALL1  400113 

SAIL 

TDNE 

612000,  ,0 

TTYMES 

CALL  I  400047 

SAIL 

TONN 

616000,  ,0 

TTYSKP 

COLLI  4e01 16 

SAIL 

TOO 

670000,  ,  0 

TTYUUO 

0S1008, , 0 

UUO 

TOOA 

674000,  ,0 

TUOSEG 

Pseudo-Op 

page  24 

TOOE 

672000, ,0 

TOON 

676000, ,0 

UFA 

130000,, 0 

TOZ 

630000, ,0 

UFBCLR 

COLLI  400012 

SAIL 

TOZR 

634000, , 0 

UFBERR 

CALL!  400060 

SAIL 

TOZE 

632000, ,0 

UFBGET 

COLLI  400010 

5AIL 

TOZN 

636000, ,0 

UFRGIV 

COLLI  400011 

SAIL 

T1HER 

CALL  1  22 

UUO 

UFBPHY 

COLLI  400055 

SAIL 

TITLE 

Pseudo-Op 

page  34 

UFB51.P 

COLLI  4000S6 

SAIL 

TLC 

641000, ,0 

UGETF 

073000,, 0 

UUO 

TLCfl 

64S000, ,0 

U1NBF 

704000, ,0 

5AIL 

TLCE 

643000. ,0 

UNIVERSAL  Pseudo-Op 

page  29 

TLCN 

647000, ,0 

UNLOCK 

COLLI  400077 

5AIL 

TLN 

601000, ,0 

UNPURE 

COLLI  400102 

SAIL 

TLNA 

605000, , 0 

UOUTBF 

70SOOO, , 0 

SAIL 

TINE 

603000, ,0 

UPG10T 

703000,, 0 

SAIL 

TLNN 

607000, ,0 

UPGMVE 

713000, ,0 

SAIL 

TLO 

661000, ,0 

UPGMVfl 

714000, ,0 

5AIL 

TLOO 

665000. ,0 

USE 

Pseudo-Op 

page  22 

TLOE 

663000, ,0 

USETl 

O74O0O,, 0 

UUO 

TLON 

667000, ,0 

USETO 

07SOOO, , 0 

UUO 

TLZ 

621000, ,0 

USK1P 

COLLI  400041 

SAIL 

TLZA 

62S'’00,  ,0 

UTPCLR 

CALLI  13 

UUO 

TLZE 

623U00, ,0 

uuositi 

CALLI  400106 

SOIL 

TLZN 

627000, ,0 

UUAIT 

COLLI  400034 

SAIL 

1HPCOR 

CALL!  44 

UUO 

THPCRO 

CALL1  400103 

SAIL 

VAR 

Pseudo-Op 

page  25 

TRC 

640000, ,0 

vosnAP 

COLLI  400070 

SOIL 

TRCO 

644000, ,0 

TRCE 

642000, ,0 

UA  IT 

COLLI  10 

UUO 

TRCN 

646000, ,0 

WAKEtlE 

COLLI  400061 

SOIL 

TRN 

600000, ,0 

UHO 

COLLI  400112 

SAIL 

TRNO 

604000, ,0 

URCV 

710040, ,0 

SOIL 

TRUE 

602000, ,0 

TRNN 

606000, ,0 

XALL 

Pseudo-Op 

page  36 

TRO 

660000, ,0 

XCREF 

Pseudo-Op 

page  37 

TPOA 

664000, ,0 

XCT 

2S6000, ,0 

TROE 

662000, ,0 

XGPUUO 

COLLI  400075 

SAIL 

TRON 

666000, ,0 

XL1ST 

Pseudo-Op 

page  36 

page  36 


page  29 
page  31 
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Stanford  Character  Set 


The  Stanford  Character  Set  is  displayed  in  the  following  table.  The  three-digit  octal  code  for  a 
character  is  composed  of  the  number  at  the  left  of  its  row  plus  the  digit  at  the  top  of  its  column 
For  example,  the  code  for  A  is  100+ 1  or  101. 

0  1  2  3  4  5  G  7 

000  NUL  i  a  (3  a  -  c  n 

010  X  TAB  LF  VT  FF  CR  »  8 

020  CDnuV3®« 

030  _  -+  -v  *  <  >  fiv 

040  SP  !  "  U  8  %  & 

050  (  )  *  +  ,  / 

060  0  1  2  3  4  5  G  7 

070  8  9  :  ;  <  =  >  ? 

100  sABCDEFG 
110  H  I  J  K  L  M  N  0 

120  P  Q  R  S  T  U  V  U 

130  X  Y  Z  t  \  ]  t  +- 

140  ‘  a  b  c  d  e  f  g 

150  h  i  j  k  I  m  n  o 

160  p  q  r  s  t  u  v  w 

170  x  y  z  I  |  ALT  )  BS 


NUL  Null 

TAB  Horizontal  Tab 

LF  Line  Feed 

VT  Vertical  Tab 

FF  Form  Feed 


CR  Carriage  Return 

SP  Space 

ALT  A I tmode 


BS  Back  Space 


FAIL 
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Summary  of  Character  Interpretations 


The  characters  listed  below  have  special  meaning  in  the  contexts  indicated.  These  interpretations 


do  not 

apply  when  these  characters  appear  in  text  strings  or  in  comments. 

000 

NUL 

nul  1 

ignored  on  input 

001 

1 

down-arrow 

makes  a  symbol  available  in  a  lower  block 

002 

0 

a  Iplia 

003 

(5 

bold 

004 

X 

logical  and 

boolean  flNO 

oos 

- 

logical  not 

boolean  NOT 

0Or 

eps  i  1  on 

da  1 imi ter  in  FOR 

III) 

11 

P' 

"  0 

X 

1 ambda 

on 

tub 

tab 

same  as  space  (848) 

012 

IF 

1 i ne  load 

1  ine  de  1  iml ter 

013 

VT 

var  Ileal  tab 

014 

FF 

lorn  lead 

line  delimiter;  causes  new  listing  page 

015 

CR 

carriage  re (urn 

statement  terminator 

016 

M 

infinity 

017 

a 

par  1 1a  l 

020 

c 

con  la inment 

dal imi tar  in  FOR 

021 

D 

impl i cal  ion 

022 

n 

sal  intersection 

023 

u 

set  union 

024 

V 

lor  al  1 

025 

3 

there  ovists 

026 

« 

circle  '  i mes 

arithmetic  sh i 1 t  operator 

027 

doul)  1  e  -arrow 

statement  terminator;  remainder  ol  line  is  interpreted  as  another  statement 

030 

underhar 

same  as  ,  (056)  in  identifiers 

031 

_» 

r i gh  t -arrow 

same  as  backslash  (134) 

032 

t  i  Ide 

same  as  up-arrow  (136);  illegal  as  the  dolimilor  in  flSCIZ,  COMMENT,  etc. 

033 

it 

not  equal 

boolean  XQR 

034 

< 

less  or  equal 

035 

> 

greater  or  equal 

same  as  net  equal  (033) 

036 

= 

equ i va lance 

037 

V 

logical  or 

boolean  OR 

040 

SP 

space 

gener  a  1  ds 1 i m i 1 er 

041 

l 

e/c l ama  1 1 on 

same  as  logical  or  (037) 

042 

H 

double  quote 

delimits  ascii  constants 

043 

tt 

number  sign 

declares  a  variable;  illegal  as  the  delimiter  In  flSCIZ,  COMMENT,  etc. 

044 

$ 

dollar  si gn 

may  ho  used  in  identi tiers 

045 

/ 

porcen  t 

may  be  used  in  identifiers 

046 

S 

ampersand 

same  as  logical  and  (004) 

04  7 

» 

c  1  ose  single  quote 

delimits  sivbit  constants 

050 

( 

left  parenthesis 

encloses  macro  arguments,  expressions,  and  index  fields 

051 

) 

right  parenthesis 

see  left  parenthesis  (050) 

052 

as  ter  Isk 

i nteqor  multiply 

053 

+ 

p  1  us 

integer  add i t ion 

054 

* 

comma 

general  argument  separator 

055 

- 

m  i  nus 

intege-  subtraction  or  negation 

056 

, 

point 

may  be  used  in  identifiers,  floating  point  numbers,  or  predefined  symbol 

057 

/ 

s  1  ash 

i n  teqer  division 

060 

0 

digits 

used  to  form  number,  parts  ot  identifiers 

071 

072 

3 

co  Ion 

used  to  deline  labels;  illegal  as  the  delimiter  in  RSCIZ,  COMMENT,  etc. 

073 

. 

som i co 1  on 

forces  remainder  ot  line  to  be  a  comment 

074 

< 

left  brolet 

delimits  complex  atoms;  same  as  led  brace  (173)  to  the  macro  processor 

075 

equa  1 

denotes  decimal  number;  alternate  to  lett-arrou  (137)  In  assignment 

076 

> 

right  brolet 

s  ta  tements 

see  to  1 1  broket  (874) 

077 

question  mark 

same  as  down-arrow  (001) 

. . .......  .. 


if 
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168  e  at-slgn  sals  Indirect  bit  In  Instructions)  precedes  concatenation  character  In  FOR 

101  A  upper  case  letters  used  tor  Identifiers)  6  and  E  are  special  In  numbers;  E  Is  special  In  FOR 

132  2 

133  ( 

134  \ 

135  1 

136  T 

137  - 

140  ' 

141  a 


172  z 

173  1 

left  brace 

delimits  macro  bodies,  lF-bodles,  FOR-bodles,  macro  arguments 

174  j 

vertical  bar 

175  AL^ 

al tmode 

same  as  right  brace  (176) 

176  1 

right  brace 

see  left  brace  (173) 

177  BS 

backspace 

i  1  legal  in  Input 

2> 


left  bracket  delimits  literals,  value  part  of  OPDEF,  size  In  RRRRY,  PPN  in  .LORD 

backslash  evaluate  a  macro  argument  and  converts  the  result  to  a  digit  string 

right  bracket  see  left  bracket  (133) 

up-arrou  moves  a  symbol  definition  to  an  outer  block;  makes  a  symbol  INTERNAL  or 

EXTERNAL;  illegal  as  the  delimiter  in  ASCIZ,  CPHflENT,  etc. 
left-arrow  denotes  assignment  statement;  arithmetic  FOR;  Illegal  as  the  delimiter  in 

ASCI2,  COHflENT,  etc. 

open  single  quote  same  as  at-slgn  (180) 

louer  case  letters  same  as  upper  case  letters,  except  In  text  constants 


t 
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Index 


1  14,  21,  23 

.  14.  21,  23 
FN  AM  1  15 
FNAM2  15 
.INSERT  35 
LIBRARY  28 
.LOAD  28 

absolute  9,  14,  50 
AC,  3 

Accumulator  Field  3 
Address  Field  4 
apostrophe  11,23 
Arguments  in  Macro  Calls  40 
Arguments  in  Macro  Definitions  39 
Arithmetic  FOR  44 
ARRAY  33 
ASC.ID  32 

ASCII  character  set  56 
Ascii  Constants  10 
ASCII  pseudo-op  32 
ASCIZ  32 

Assembler  Control  Statements  34 

assignment  statement  13 

ASUPPRESS  29 

at-sign  3,  43 

atomic  statement  4,  6,  20 

atoms  6,  8 

available  9,  15,  17 

backslash  41 
backward  reference  12 
BEC1N  26 
BEND  26 
blank  38 
block  9 

block  number  26 
BLOCK  pseudo-op  33 
Block  Structure  15 
braces  38,  4  1,  44 
brackets  19,  33,  41 
brokets  4,  19,  20,  38,  4 1 
BYTE  30 
byte  pointer  31 


close  single  quote  1 1,  23 
colon  3,  13,  15,  32,  35 

comma  3,  5,  23,  26,  27,  30,  31,  32,  33,  38,  40, 
44,  48 

comma-comma  4 
Command  Language  48 
comment  6 

COMMENT  pseudo-op  34 
COMP1L  49 
Complex  Atoms  19 
concatenation  character  39,  43 
Conditional  Assembly  46 
Constants  9 

constants  optimization  20 
containment  character  43 
control-meta-line  feed  49 
control-Z  49 
CREF  1,  37,  48 
CREF  pseudo-op  37 
Cross-Reference  Listing  37,  48 

DDT  I,  15,  18,26,  32,  34 
DEC  pseudo-op  30 
Decimal  Numbers  10 
decimal  point  10 
DEFINE  pseudo-op  38 
defined  9,  12 
DEPHASE  23 

Destination  of  Assembled  Code  22 

device  code  5 

Device  Selection  Field  5 

dollar  sign  8 

dollar-point  14,  21,  23 

double  quote  10 

double-arrow  6 

down-arrow  5,  17,  19,  47 

END  34 

Entering  Data  30 
ENTRY  19,27 
entry  blocks  19,  27 
entry  point  19 
epsilon  44 

equal  sign  10,  13,  15,  35 
Expressions  6 
EXTERNAL  18,  27 
external  symbols  18,  27 


carriage  return  6,  34,  36,  39,  41 
Character  FOR  44 
character  interpretations  57 


fixup  12 
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Floating-Point  Numbers  10 
FOR  43 
FOR-body  43 
form  feed  37 
formal  arguments  43 
forward  reference  12,  33 
Full-Word  Expression  5 

GLOBAL  pseudo-op  26 
global  symbols  18 

Half-Killed  Symbols  15 
Halfword  Statement  4 
hardware  input-output  instruction  5 
hardwore  instruction  3,  51 
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